Universal Spool Remove for zOS

Databases

Universal Spool databases are implemented as HFS or zFS data sets.

HFS Data Sets

Universal Spool Remove (USLRM) and Universal Spool List (USLIST) 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
spool.stdout.COMPID.db
spool.stderr.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, USLRM and USLIST 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, USLRM and USLIST 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.

 
 

USLRM and USLIST 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.

USLRM and USLIST 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 Remove for z/OS JCL procedure (USLRMPRC, located in the SUNVSAMP library) that is provided to simplify the execution JCL and future maintenance.


//USLRMPRC PROC UPARM=,               -- USLRM options
//             UNVPRE=#SHLQ.UNV,
//             CFGPRE=#PHLQ.UNV,
//             DBPRE=#PHLQ.UNV
//*
//PS1      EXEC PGM=USLRM,PARM='ENVAR(TZ=EST5EDT)/&UPARM'
//STEPLIB  DD  DISP=SHR,DSN=&UNVPRE..SUNVLOAD
//*
//UNVNLS   DD  DISP=SHR,DSN=&UNVPRE..SUNVNLS
//UNVCONF  DD  DISP=SHR,DSN=&CFGPRE..UNVCONF
//UNVDB    DD  DISP=SHR,DSN=&DBPRE..UNVDB
//UNVSPOOL DD  DISP=SHR,DSN=&DBPRE..UNVSPOOL
//UNVTRACE DD  SYSOUT=*
//CEEDUMP  DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//SYSOUT   DD  SYSOUT=*
//SYSPRINT DD  SYSOUT=*


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 Remove for z/OS JCL procedure, above.
 

ddname

Description

STEPLIB

Load library in which program USLRM program is located.

UNVNLS

Universal National Language Support library.

UNVCONF

Universal Agent configuration library.

UNVDB

Universal Broker Database HFS data set.

UNVSPOOL

Universal Spool Database HFS data set.

UNVTRACE

Application trace ddname.

SYSOUT

USLRM standard error ddname.

SYSPRINT

USLRM standard output ddname.

JCL

The following figure illustrates the Universal Spool Remove for z/OS JCL using the USLRMPRC JCL procedure, above.


//STEP1    EXEC PGM=USLRM
//STEPLIB  DD  DISP=SHR,DSN=UNV.SUNVLOAD 
//UNVNLS   DD  DISP=SHR,DSN=UNV.SUNVNLS
//UNVCONF  DD  DISP=SHR,DSN=&CFGPRE..UNVCONF
//UNVDB    DD  DISP=SHR,DSN=UNV.UNVDB 
//UNVSPOOL DD  DISP=SHR,DSN=UNV.UNVSPOOL 
//UNVTRACE DD  SYSOUT=* 
//CEEDUMP  DD  SYSOUT=* 
//SYSUDUMP DD  SYSOUT=* 
//SYSOUT   DD  SYSOUT=* 
//SYSPRINT DD  SYSOUT=*
//SYSIN    DD  *
command options
/*



If zFS data sets are being used instead of the default HFS data sets, the UNVDB and UNVSPOOL ddnames cannot be used to allocate the zFS data sets. The ddnames must be removed along with the DBPRE procedure parameter.

Configuration Options

The following table identifies the Universal Spool Remove for z/OS configuration options. Each Option Name is a link to detailed information about that option.


Option Name

Description

COMPONENT

Component identifier for which records will be removed.

HELP

Writes a description of the command options and their format.

MESSAGE_LEVEL

Level of messages that will be written.

MOUNT_POINT

HFS directory in which the HFS databases allocated to ddnames UNVDB and UNVSPOOL are mounted.

VERSION

Writes the program version and copyright information.

Command Line Syntax

The following figure illustrates the command syntax — using the command line, long form of the configuration options — of Universal Spool Remove for z/OS.

uslrm
-component cid 
[-mount_point dir]
[-level {audit|info|warn|error}]

uslrm
{ -help | -version }