SCC-DLIMIT ISPF interface - syncsort_scc_monitor - Latest

The profile panel

DLimit administration functions

Option 2 of the System Administration Functions Panel specifies the DLimit Database Backup function. The active DLimit database is actually a VSAM relative-record dataset and thus may be backed up like any other VSAM file. However, it may be desirable to make additional backup copies of the DLimit database, either for testing purposes, disaster recovery, or for reporting. This series of panels allows the DLimit administrator to invoke DLMAINT to make a sequential copy of the DLimit database. The result of the DLMAINT BACKUP command is a sequential file which can be used as input to the DLMAINT restore command.

Database Name The DLimit database name may be specified as ‘ACTIVE’ indicating the currently active database should be used. The dataset name of another database may be specified, which is not the currently active database.

Output Dataset Specifies the sequential output dataset which is to be used for backup of the DLimit database. If the specified dataset exists, it will be used. If the dataset does not exist, DLimit will display panels allowing the user to enter allocation characteristics to define the dataset. The DCB charac- teristics will be supplied by DLMAINT. They are DSORG=PS, RECFM=FBA, LRECL=128.

DLimit database restore

Option 3 of the System Administration Functions Panel specifies the DLimit Database Restore function. The active DLimit database is actually a VSAM relative record dataset and thus may be backed and restored as part of the normal system backup and restore pro- cess. If the DLMAINT BACKUP statement has been used to make a sequential copy of the DLimit database, this copy may be used to load the active database, or another VSAM RRDS which may be used for reporting.

Figure 5-9. DLimit Database Restore Panel

Input Dataset Name specifies the name of the sequential file which contains a backup of the DLimit database that was created via the DLMAINT BACKUP statement. This dataset must exist prior to beginning the restore.

Database Name refers to the DLimit database name which is to be the target of the restore operation. This database may be specified as ‘ACTIVE’ meaning the currently active database is the target of the restore. Another dataset name may be specified to indicate that the backup is to be loaded into a different cluster. Once loaded, DLimit TSO commands and DLMAINT or DLimit reporting MONRUN jobs may be run against the loaded data- base to obtain space accounting information.

DLimit database resynchronization

When DLimit is first installed, the DLimit database is empty. In order to load the DLimit database with information about existing datasets, the DLMAINT RESYNC function can be used to examine the VTOCs of the installation’s DASD volumes and execute the DLimit rules to assign each dataset to one or more space accounts. There are several other instances when it may be necessary to update the DLimit database with current informa- tion via the DLMAINT RESYNC statement, such as when:

• Disk space has been released without going through the system allocation exits (as in Compaktor volume reorganization or RLSE processing).
• DASD volumes have been reconstructed from full-volume and/or incremental backups.
• DLimit has been inactive and has not been recording requests for direct-access space, or additional applications are to be added to DLimit control.
• A new ICF catalog is to be used for the DLimit database

Figure 5-10. DLimit Database Resynchronization Panel

The following fields may be entered on this panel:

Database Name The name of the VSAM file which serves as the DLimit database. ‘ACTIVE’ indicates the currently active database. Another dataset name may be specified if the resynchronization is to be performed on a database which is not the active database.

CLEAR Accounts to zeroIndicates that space amounts for selected accounts (which may be all accounts) are to be reset to zero prior to the start of RESYNC pro- cessing. Setting the space amounts to zero allows the space amounts to

be completely recalculated for each account; however, all datasets that might be assigned to the account must be processed. If the accounts are not initialized to zero, the space amounts detected by RESYNC are sim- ply added to the current amount.

Issue Hardware RESERVEsIndicates whether or not a hardware RESERVE is to be per- formed to prevent space requests from taking place on each volume before DLimit RESYNC has finished processing it. This option is not recommended

Provide Detail ReportIndicates whether or not a detail report on account space utilization is to be included in the SYSPRINT output from the RESYNC job. The default is to include account detail information.

Selecting Accounts

Pressing ENTER on the RESYNC Specifications panel causes the Account Selection Panel to be displayed. This panel is used in several places in the DLimit ISPF interface to provide selection criteria for which DLimit accounts are to be processed. The DLimit database name to be used may be entered, either as ‘ACTIVE’, or as another, alternate database name.

Figure 5-11. Selecting Accounts for Resynchronization

Selecting volumes

After account selection criteria has been specified, the DASD volumes which DLimit is to process during RESYNC may be specified. For each selected volume, the VTOC is read and the DLimit rules are run for each dataset or ICF VSAM component on the volume. If the rules assign space for the dataset to an account, the amount of space occupied by the dataset is added to the appropriate category within the account.

DLMAINT RESYNC will issue a RESERVE on each volume, if specified in the RESYNC Specifications panel, before processing the VTOC. The RESERVE is released immediately after processing on the volume is complete.

Figure 5-12. Selecting Volumes for Resynchronization

Selecting datasets

After volume selection criteria has been specified, the datasets which DLimit is to process during RESYNC may be specified. For each selected volume, the VTOC is read and the DLimit rules are run for each dataset or ICF VSAM component on the volume. If the rules assign space for the dataset to an account, the amount of space occupied by the dataset is added to the appropriate category within the account. DLimit will process only those data- sets which this panel specifies are to be included in RESYNC processing.

Figure 5-13. Selecting Datasets for Resynchronization

Batch job submission

Some of the DLimit ISPF functions require that batch jobs be submitted. The JOB state- ment, STEPLIB DD statement, and other required JCL information may be entered on the Job Statement Entry Panel. Prior to submitting the batch job, DLimit displays the Batch Job Submission panel, which provides options for the manner in which the batch job is to be submitted. The panel is shown below:

Option 1 submits the job for execution immediately.

Option 2 invokes the ISPF editor to allow the user to examine and modify the JCL. When the edit session is complete, the job is submitted for execu- tion.

Option 3 invokes the ISPF editor. If desired, the user may issue the TSO SUB- MIT command from the ISPF edit session. DLimit does not submit the job for execution when the edit session is finished.

DLMAINT Utility Menu Panel

The DLMAINT Utility Menu allows the user to invoke DLimit TSO commands and DLimit statements using the DLMAINT batch utility. While the DLimit TSO commands may be issued directly from TSO in order to obtain or change information in the default DLimit database, they must be run under the DLMAINT program in order to access alter- nate DLimit databases.

Figure 5-15. DLMAINT Utility Menu Panel

The first 5 menu items allow the user to specify DLimit TSO commands to run under DLMAINT. The remaining choices allow the user to perform the following types of spe- cial DLMAINT processing:

ERASE This command is used to set the space amounts for all categories in specified accounts to zero.

SCAN This command is used to execute the DLimit rules against all or selected accounts. This may be useful in order to make mass changes, such as changing the maximum space limit, across all or selected accounts.

Display and modify accounts

Displaying DLimit Account Information

Specifying option 2 (LIST ACCOUNTS) on the DLimit main ISPF panel results in the display of the Account Selection Criteria Panel. This panel allows the user to select desired DLimit accounts for display. The default is to display all DLimit accounts. An individual DLimit account name or account name mask may be entered to display a subset of the DLimit accounts. A trailing asterisk may be used to indicate an account name mask. A question mark may be used as a single-character wildcard.

Space Account Status Panel

The Space Account Status panel displays a table of DLimit accounts. For each account, the current space used, maximum space limit, high water mark, and other information are displayed.

Figure 5-17. Space Account Status Panel

Space Account Status Panel

The table may be sorted by specifying ‘SORT n x’, where ‘n’ is the number of the column to be sorted (i.e., 1=account name, 2=space used, 3=max limit, and so on) and ‘x’ is the sort order. Alternatively, the name of the column may be specified as the sort key (e.g., ’used’, ’limit’, ’max’, etc.) The sort order may be either ‘A’ (ascending) or ‘D’ (descend- ing). The table is initially sorted in ascending order of account name. ‘D’ is the default sort order if the SORT command is issued without either ‘A’ or ‘D’.

Space Account Status Panel Line Operators

The following line operators may be specified in the ‘Cmd’ column to perform actions on individual accounts:

‘S’ Selects an account for updating and displays detail information on the account..

’E’ Selects an account for editing and displays detail information on the account. Space amounts and other fields may then be selected for updat- ing.

‘I’ Inserts a line for a new account and displays a panel that allows the user to enter a name and other information for the new account.

‘D’ Deletes the specified account from the DLimit database.

Account Characteristics Panel

This panel is displayed when an account is selected from the Space Account Status Panel. If the ’S’ option was used to select the account, the values are read-only and may not be updated. If the ’E’ option was used, values for the account may be changed.

Figure 5-18. Account Characteristics Panel

Account Name The name for the account.

Description Up to 20 characters of identifying information for the account

Current Space UsedThe space currently occupied by datasets belonging to the account.

Max Space AllowedThe maximum amount of space allowed for the account. If the total space assigned to the account exceeds this value, warning messages may be issued or subsequent requests for space may fail, depending upon the MODE setting for the account. A value of zero in this field indicates there is no limit on the amount of space in the account.

High Water MarkThe largest total amount of space that was ever assigned to the account. The current space amount may be less than this value if space was released or datasets deleted after the highwater mark was reached.

Created on The Julian date on which the account was created. This may be the date the account was first assigned to a dataset, or it may be the date the account was explicitly created via the DLADD command.

Last Used on The Julian date on which space was most recently added to or subtracted from the account.

Issue Warnings if Over LimitIndicates whether warning messages are to be issued when the account is approaching the maximum space limit.

Warning Limit Percent UtilizationThe percentage of the maximum limit at which warn- ing messages are to be issued to inform the user that they are approach- ing account limits. Warnings are issued if the current space utilized in the account exceeds the warning percentage.

Mode The type of action to be taken if the maximum space limit is exceeded.

TSO Userid to Receive Overlimit MessagesSpecifies an optional TSO userid which is to receive warning and error messages if an account is approaching or exceeds the maximum limit set for the account. Normally, messages are issued only to the job log of the job which is over limit.

Logfile DDname to Receive Overlimit MessagesSpecifies the DD name of an optional log file DD allocated to the DIF started task which will receive warning messages or error messages if an account is approaching or exceeds the maximum limit set for the account. Normally, messages are issued only to the job log of the job which is over limit.

Selecting a DLimit account

Option 3 (SELECT ACCOUNT) on the DLimit main ISPF panel causes the Account Selection Menu panel to be displayed. This panel allows actions to be taken against a specified DLimit account. The full account name must be specified in the ‘Account Name’ field. One of the four menu options should be entered in the ‘Function’ field. If no option is specified, option 1 (DISPLAY) is assumed.

Figure 5-19. Selecting an DLimit Account

The following functions may be selected:

Display Displays the characteristics of the specified account

Add Adds a new account with the specified name to the DLimit database.

Delete Deletes the specified account from the DLimit database.

Alter Allows the user to update account information.

Figure 5-20. Account Characteristics Panel

The fields displayed in the Account Characteristics Display panel are the same as those discussed in the previous section.

Modifying Account Characteristics

Selecting option 4 (ALTER) from the Account Selection Menu causes the Account Char- acteristics Display panel to be displayed in the same manner as if option 1 (DISPLAY) was selected. However, selecting option 4 allows values in the Account Characteristics Display to be overwritten. Overwritten values are used to update the TOTAL category in the account in the DLimit database.

Adding an Account

Selecting option 2 (ADD) from the Account Selection Menu adds a new account to the DLimit database with the specified name. The characteristics of the account specified as a model account, if any, are used to create the account. The Account Characteristics Panel is then displayed to allow the default values in the account to be modified.

Deleting an Account

Selecting option 3 (DELETE) from the Account Selection Menu deletes the specified account from the database.

Adding or deleting multiple accounts

Adding Multiple Accounts

Selecting Option 4 (ADD ACCOUNTS) from the DLimit ISPF main menu causes the Add Accounts panels to be displayed. Up to 20 fully-specified names of DLimit accounts may be specified on this panel. The specified accounts will be added to the DLimit data- base. The model account specified, if any, will be used to set the account characteristics for new accounts.

Figure 5-21. Adding New Accounts to DLimit

If any error is encountered while processing the list of accounts, such as attempting to add an account which already exists, then processing halts at the point of error. The remaining accounts are not added.

Adding or Deleting Multiple Accounts

Selecting Option 5 (DELETE ACCOUNTS) from the DLimit ISPF main menu causes the Remove Accounts panels to be displayed. Up to 20 fully-specified names of DLimit accounts may be specified on this panel. The specified accounts will be deleted from the DLimit database.

If any error is encountered while processing the list of accounts, such as attempting to delete a nonexistent account, then processing halts at the point of error. The remaining accounts are not deleted.

Report

REPORT

Command Selection Criteria

The REPORT command of the DLMAINT utility can be used to determine which accounts datasets are assigned to, according to the DLimit rules currently in effect. The Report command panel may be selected via option 6 (REPORT) from the primary DLimit ISPF panel.

This panel allows the user to specify parameters for the REPORT command of DLMAINT, used to determine which account(s) a dataset should be assigned to, and how many accounts will be assigned, based upon information obtained from the VTOC.

Figure 5-23. Report Criteria Panel

The following fields may be specified:

Provide Account DetailsIndicates whether individual datasets should be included in the report or only a summary of accounts and the number of datasets assigned to each account. This field is required.

Sort Datasets By If dataset information is to be included in the report, the detail entries may be sorted. This field indicates the sort key to be used.