Console Commands › CA GTS System Commands › LOGGER Command

LOGGER Command

The LOGGER command interacts with the unified logger which allows all components and clients in the CA GTS address space to safely write to multiple data sets without conflicts.

Before it can use a data set or SYSOUT class, the corresponding DD statement must be activated. This can either occur in the LOGGER00 member of CAGSPARM or using a console command.

The console command has the following format:

F gts,LOGGER keyword

DEBUG(YES|ON|NO|OFF)

Modifies the generation of debugging messages. This should only be turned on at the request of CA Support.

INFO

Displays a list of all data sets/SYSOUT, both opened and closed, defined to the CA GTS logger component. The logger is only able to write to DD statements that were defined to CA GTS, either through the CAGSPARM LOGGERxx member or a console command.

CLOSE DD(xxxxxxxx)

Closes a DD statement currently available to the logger. This allows for spinning off of SYSOUT data sets or the copying of data sets without the need of shutting down CA GTS system.

OPEN DD(xxxxxxxx)

Opens a DD statement currently defined and available to CA GTS. Use this command with the CLOSE command to handle spin-off of SYSOUT and dynamic allocation of new data sets.

FREE DD(xxxxxxxx)

Deallocates a DD statement and makes it available to allocation by other address spaces. DD statements that were freed may subsequently be allocated again.

ALLOC(subparameters)

Indicates a DD statement to be allocated to CA GTS using the DD(), DSN()|SYSOUT() and DISP() keywords. Using the TIMESTAMP() keyword, an optional timestamp may subsequently be inserted into the records written to this DD.

DD(xxxxxxxx)

Specifies the one-to-eight character DDNAME to use for allocating a data set or SYSOUT class

DSN(xxx…xx)

States the one-to-44 alphanumeric name of a data set. Use this to allocate to the DD statement using the DD keyword. The DSN and SYSOUT keywords are mutually exclusive.

SYSOUT(x)

Names the one-character output class to allocate to the DD statement specified using the DD keyword. The use of DSN and SYSOUT is mutually exclusive.

DISP(SHR|MOD|OLD)

Indicates the disposition to use for the allocation of the data set specified with the DSN keyword. Do not specify a disposition when allocating to a SYSOUT class.

TIMESTAMP(YES|ON|NO|OFF)

Determines whether to add a timestamp to every record output for this DD statement

F GTS,LOGGER INFO
CAGS02180I Logger dataset information for GTS CA11 follows                                                      
CAGS02190I DD: GTSSNAP , DSN: ERNRO03.CA7GS.STC58994.D0000103.?           , DSORG: PS  , DISP: MOD, TYPE: SYSOUT
CAGS02200I LRECL:   141, BLKSIZE:   141, RECFM: F  , Open                                                       
CAGS02190I DD: GTSPRINT, DSN: ERNRO03.CA7GS.STC58994.D0000101.?           , DSORG: PS  , DISP: MOD, TYPE: SYSOUT
CAGS02200I LRECL:   121, BLKSIZE:   121, RECFM: F  , Open                                                       
CAGS02190I DD: GTSDEBUG, DSN: ERNRO03.CA7GS.STC58994.D0000102.?           , DSORG: PS  , DISP: MOD, TYPE: SYSOUT
CAGS02200I LRECL:   121, BLKSIZE:   121, RECFM: F  , Open