DISC Configuration Syntax

DISC Configuration is available on: NONSTOP only

Both the Disk Manager and User Accounting products are configured through the DISC Configuration. In this configuration, the following details can are specified:

  • What disk volumes are to be monitored,

  • Which Measure FILE entities to collect,

  • The interval during which Measure and Filespace data will be collected,

  • The maximum file space to use for the Measure work files,

  • Which files to monitor at a detailed level.

Because of the overheads associated with monitoring files on a system, only files specified in the DISC Configuration will be monitored on the HPE NonStop server. Due to this, the DISC Configuration is not set by default.

SUBSYS DISC

[INTERVAL (<number-of-minutes>)]
[INTERVAL PHYSVOL (<number-of-minutes>)]
[ADD DISC ({* | <entity>} [, ...])]
[ADD DISCOPEN ({* | <entity>} [, ...])]
[ADD PHYSVOL ({* | <entity>} [, ...])]
[ADD FILE ({* | <entity> | DISC-FILES | OTHER-FILES | PROCESS-FILES | RECEIVE-FILES} [, ...])]
[MONITOR [SPACE] (<file-name>, <file-name>, ...)]
[EXCLUDE {DISC | SUBVOLUME}(<disc-list>)]
[EXCEPT FILEFULL (<full-percent>)]
[EXCEPT INDEXLEV (<num-levels>)]
[EXCEPT LASTPART (* | K | E | R | U)
[TRACK PARTITIONS ({Y | N})
[SIZE (<number-of-megabytes>)]

Syntax Elements

(++) The maximum number of entries quoted for ADD FILE, ADD DISCOPEN, and MONITOR are not cumulative, that is, you can have a maximum of 252 MONITOR entries or 398 ADD FILE entries or 649 ADD DISCOPEN entries.

INTERVAL

Specifies the interval (in minutes) during which the Disk Collector Subsystem will gather Measure and Filespace Data. This interval will impact on the overheads of collecting Disk Management data with these overheads being directly proportional to the number of disks and files on the system. The INTERVAL statement occurs once in the configuration screen with the minimum collection interval being 5 minutes.

The default used if the INTERVAL statement is not specified will be automatically calculated. This calculation takes into account the number of disks on the system and the estimated speed of I/O operations on the disk, but it will not be less than 1 hour. With all modern systems, in all but the largest ones (those with >1,000 disks), the default will end up being 1 hour.

The FILEDET record EOF field (and some other fields in FILEDET that are not populated by Measure) may take 2 collection intervals to update. This is by design to minimise overheads.

INTERVAL PHYSVOL

The PHYSVOL interval specifies the interval (minutes) during which the Disk Collector subsystem will gather the PHYSVOL record. This allows more frequent updates of critical Volume information without the overheads associated with gathering file level data. INTERVAL PHYSVOL occurs once in a configuration screen. If omitted, the specified INTERVAL parameter will be used.

ADD DISC

Specifies the disks to be monitored by the Disk Collector subsystem. Each disk specified here will have its directory read each interval.

Omitting a disk will mean that disk-related statistics for this disk will not be collected. This also means that the overhead associated with reading the disk directory will be avoided. However, the reading of a disk directory results only in a small amount of overhead.

Enclose multiple disk names in brackets Disk names can span multiple lines and the ADD DISC statement can occur multiple times. An asterisk (*) indicates all disks.

ADD DISCOPEN (++)

Defines which Measure DISCOPEN entities will be collected. An asterisk (*) indicates all DISCOPEN entities.

The ADD DISCOPEN clause can occur multiple times with a maximum limit of 649 entries.

ADD PHYSVOL

Specifies the disks to be monitored for the PHYSVOL record by the Disk Collector Subsystem. Enclose multiple disk names in brackets. Disk names can span multiple lines and the ADD PHYSVOL statement can occur multiple times. An asterisk (*) indicates all disks. If this line is omitted then the disk names specified in ADD DISC will be used.

ADD FILE (++)

Defines which Measure FILE entities will be collected to populate fields in the NonStopUser (USER), NonStopUserGroup (GROUP) and NonStopJobObject (OBJECT) records. An asterisk (*) used in this statement indicates Measure data should be collected for any file opened. The FILE entities entered here must be located on a disk specified in the ADD DISC statement. The ADD FILE statement can occur multiple times with a maximum limit of 398 entries.

The records read back from Measure giving information on logical I/O’s, MSG, and BYTE rates for any open file, whether a file is local or remote.

Omitting a FILE entity by using a more selective ADD FILE clause will mean I/O, MSG and BYTE rates associated with the opened file will not be collected. This will also save on associated Measure overhead. This overhead can be significant where many files are being opened and closed.

The ADD FILE clause supports the special keywords and wildcards shown below.

ADD FILE (.........)

Configures File Opens for....

Fields affected by the clause start with...

\<node>.$*

Processes on the foreign node

EXPAND

\<node>.$*.*

Subdevices on the foreign node

EXPAND

\<node> or \<node>.$*.*.*

All files opened on the foreign node

EXPAND

*

All files opened on the local node

All, except EXPAND

$*

Processes and $RECEIVE files on the local node

PROC, RECVIOS, TAPE

$*.*

Subdevices and temporary disk files on the local node

COMM, PRINT, TERM, DISC

$*.*.*

All files opened on the local node

All, except EXPAND

\*.* or \* or \*.$*.*.*

All files opened on all nodes

All

DISC-FILES/p>

Disk files and temporary disk files on the local node

DISC

OTHER-FILES

Subdevices and temporary disk files on the local node

DISC, COMM, PRINT, TERM

PROCESS-FILES

Processes on the local node

PROC, TAPE

RECEIVE-FILES

$RECEIVE files on the local node

RECVIOS

The following ADD FILE statements show the equivalent of the special keywords being used:

ADD FILE ( $* )         = ADD FILE (PROCESS-FILES, RECEIVE-FILES )
ADD FILE ( * )          = ADD FILE ($*.*.* )
ADD FILE ($RECEIVE)     = ADD FILE (RECEIVE-FILES)
ADD FILE ( $*.*.* )     = ADD FILE (DISC-FILES, PROCESS-FILES, RECEIVE-FILES)
ADD FILE ( $*.* )       = ADD FILE (PROCESS-FILES, RECEIVE-FILES, OTHER-FILES)

There is no equivalent syntax for the following clauses:

ADD FILE (OTHER-FILES)	= subdevices and temporary files.
ADD FILE (DISC-FILES)	= disk files opened on the local node.
ADD FILE (\*.$*)		= processes opened on other nodes.

MONITOR [SPACE]  (++)

Specifies that detailed file monitoring should be performed on the specified file(s). Monitored files are returned in the FILEDET record. Detailed data includes file space and rate information. Specifying a file in MONITOR implies ADD FILE and ADD DISCOPEN for the file. This is included automatically the Disk Manager. The optional SPACE parameter specifies that only non-measure data, i.e. filespace data, will be collected. This saves on collection overhead.

The MONITOR clause can occur multiple times with a maximum limit of 252 entries.  The MONITOR SPACE clause does not have a limit as to when you use this entry only file space details are collected and no Measure data is collected.

MONITOR also allows the specification of file names using partial wildcards. '*' matches zero or more letters or digits, '?' matches exactly one letter or digit. The '*' and '?' wildcard characters may be used anywhere in a filename, except as the first character which must be $.

Monitoring files are intended for use on critical files only as there is memory overhead associated with monitoring large numbers of files.  Do not, for example, add a clause MONITOR ( *, *, *) as this may cause STDC to abend as it may make STDC use too large a memory area.  We suggest you monitor only specific files or subvolumes.  You can also add Logical files to the monitor clause where SMF is installed on your system.

EXCLUDE

The EXCLUDE option allows you to exclude certain disks from monitoring. This will reduce overheads and prevent the generation of exceptions for Disk's that are not important to your environment. The keywords of DISC or SUBVOL are appended to the EXCLUDE parameter, both of these keywords can be included by using multiple EXCLUDE statements in the configuration file.

EXCLUDE DISC

Specifies a list of disc volumes for which no data is to be collected. EXCLUDE DISC clauses should be specified after ADD DISC clauses.

e.g. ADD DISC ( * )
       EXCLUDE DISC ( $SYSTEM )

This will mean that VOLUME, SUBVOL or EXCEPT records will NOT be created for $SYSTEM. FILEDET record can still be generated for $SYSTEM specifying in the MONITOR clause. It also means that this disc data (i.e. virtual files mapped on this physical disc) will not be added to any VIRTVOL or SMFPOOL figures.

EXCLUDE SUBVOL

Disables the SUBVOL record for the specified list of discs. However, VOLUME and EXCEPT records for this disc will NOT be affected. EXCLUDE SUBVOL clauses should be specified after ADD DISC, EXCLUDE DISC clauses.

EXCEPT FILEFULL

The FILEFULL value specifies the percentage full which the Disk Collector subsystem will monitor for. If it detects a file exceeding this threshold then a EXCEPT record will be created for the file. The maximum number of exception records that can be created is created is 100 * <number-of-monitored-disks> to a maximum of 32.767 entries.

e.g. EXCEPT FILEFULL ( 90 )

EXCEPT INDEXLEV

The INDEXLEV value specifies an index level threshold. If the Disk Collector subsystem detects a file 'equal to' or 'greater than' this threshold level then an EXCEPT record will be created for the file. The maximum number of exception records that can be created is 100 * <number-of-monitored-disks> to a maximum of 32,767 entries.

e.g. EXCEPT INDEXLEV ( 3 )

EXCEPT LASTPART

Every open partition will generate a FILEFULL exception when it exceeds the file full percentage set in the EXCEPT FILEFULL parameter. The EXCEPT LASTPART parameter will configure the disc collector so that FILEFULL EXCEPT records will only be generated when the last partition becomes full.

The syntax includes the following file type options:
*                 all file types
K                key sequenced files
E                entry sequenced files
R                relative files
U                unstructured files

Multiple EXCEPT LASTPART entries can be added, or multiple file types (delimited by commas) can be specified. For EXCEPT LASTPART processing to function, the physical volume containing the primary partition must be added to the DISC Configuration in the ADD DISC parameter.

TRACK PARTITIONS

Set to Y (Yes) to enable, or N (No) to disable this feature. Enabling this feature will identify the last partition for all SQL/MP and Enscribe partitioned files. The last partition will be marked with an 'L' in the FLAGS field of the NonStopDetail (FILEDET) and NonStopFileException (EXCEPT) records, regardless of whether an EXCEPT LASTPART statement has been configured in the DISC Configuration

Enabling the TRACK PARTITIONS feature also means that spurious corrupt file exceptions can be avoided for SQL/MP tables that are currently being loaded. When an SQL/MP LOAD is executed, LOAD sets the corrupt flag on all files to be loaded before the load starts and resets the flag when the load finishes successfully. Normally, a NonStopException (EXCEPT) record entry will be generated for a file that is corrupt but not open for write. As the files being reloaded by SQL/MP LOAD are not really corrupt, the TRACK PARTITIONS statement when set to Y (Yes) will enable the detection of SQL/MP files that are currently being loaded and avoid flagging them as corrupt. In addition, the corruption flag is suppressed in the flags field of the NonStopFileDetail (FILEDET) record.

SIZE

Specifies the maximum amount of space (in megabytes) that Measure can use in one cycle for storing the FILE and DISCOPEN entities. SIZE occurs once in a configuration screen.

Example:

SUBSYS DISC

INTERVAL (5)
INTERVAL PHYSVOL (5)
ADD DISC (*)
ADD PHYSVOL (*)
ADD FILE (\NODE1.$*.*.*, \NODE2.$*.*.*)
MONITOR ($*.ELMER.*)
MONITOR ($*.LMSG04.*, $*.LMSG05.*, $*.LMSG06.*, $*.LMSG07.*)
MONITOR ($*.MPDATA.*, $*.MPSSF.*, $*.MPSUSP.*)
MONITOR ($USER.*.*)
MONITOR ($reltst.*.*)
MONITOR SPACE ($SYSTEM.SUBVOL1.*)
EXCLUDE DISC ($SYSTEM)
EXCLUDE DISC ($ISV)
EXCLUDE SUBVOL ($SYSTEM.SUBVOLA)
EXCEPT FILEFULL (60)
EXCEPT INDEXLEV (3)
EXCEPT LASTPART (R,K)
TRACK PARTITIONS (Y)
SIZE ( 50 )
Provide feedback on this article