Universal Spool List for zOS
Databases
Universal Spool databases are implemented as HFS or zFS data sets.
HFS Data Sets
Universal Spool List (USLIST) and Universal Spool Remove (USLRM) obtain the HFS data set names from UNVDB and UNVSPOOL ddnames.
The following table identifies the database files and the HFS data sets in which they reside.
Database Name | Data Set | File Name |
|---|---|---|
Universal Broker Component Database | UNVDB | bcomponent.db |
Universal Server Component Database | UNVDB | scomponent.db |
Universal Server Spool Databases * | UNVSPOOL | spool.stdin.COMPID.db |
* The COMPID in the Universal Server Spool Databases file names is the component ID assigned to the Server instance.
zFS Data Sets
zFS data sets cannot be provided via ddnames. To obtain the zFS data set names, USLIST and USLRM allocate and parse the Universal Broker's configuration member, UBRCFG00, for the UNIX_DB_DATA_SET and UNIX_SPOOL_DATA_SET options. If these options are not found, USLIST and USLRM assume that HFS data sets are being used and refer to the UNVDB and UNVSPOOL ddnames for the HFS data set names.
Note
You can use these configuration options to specify HFS data sets as well if this method is preferred over specifying them as a ddname allocation.
USLIST and USLRM mount the HFS and zFS data sets if they are not already mounted.
The Universal Agent configuration PDSE is allocated to UNVCONF in the USLLSPRC and USLRMPRC JCL procedures in the SUNVSAMP library. The only other changes to USLLSPRC and USLRMPRC is the addition of a comment that the UNVDB and UNVSPOOL ddnames must be commented out to use zFS data sets.
USLIST and USLRM write messages UNV2264I and UNV2265I, which provide information on the Broker's database and spool, respectively. The messages also provide the file system type, data set name, and mount point.
JCL Procedure
The following figure illustrates the Universal Spool List for z/OS JCL procedure (USLLSPRC, located in the SUNVSAMP library) that is provided to simplify the execution JCL and future maintenance.
Note
If zFS data sets are being used instead of HFS data sets, the UNVDB and UNVSPOOL ddnames cannot be used to allocate those zFS data sets. They must be removed, along with the DBPRE procedure parameter.
DD Statements used in JCL Procedure
The following table describes the DD statements used in the Universal Spool List for z/OS JCL procedure, above.
ddname | Description |
|---|---|
STEPLIB | Load library in which program USLIST program is located. |
UNVNLS | Universal National Language Support library. |
UNVCONF | Universal Agent configuration library. |
UNVDB | Universal Broker Database data set (HFS only). |
UNVSPOOL | Universal Spool Database data set (HFS only). |
UNVTRACE | Application trace ddname. |
SYSOUT | USLIST standard error ddname. |
SYSPRINT | USLIST standard output ddname. |
JCL
The following figure illustrates the Universal Spool List for z/OS JCL using the USLLSPRC JCL procedure, above (for HFS data sets).
Configuration Options
The following table identifies the Universal Spool List for z/OS configuration options. Each Option Name is a link to detailed information about that option.
Option Name | Description |
Component identifier for which records will be selected to write. | |
Writes a description of the command options and their format. | |
Type of database from which to select record to write. | |
Level of messages that will be written. | |
HFS directory in which the HFS databases allocated to ddnames UNVDB and UNVSPOOL are mounted. | |
Writes the program version and copyright information. |
uslist [-list {ubroker|ucmd|urmtcfg|stdin|stderr|stdout}] [-component cid] [-mount_point directory] [-level {audit|info|warn|error}] uslist { -help | -version }