Tandem Logon Manager for IBM Systems (ILOGMGR) Manual

Configuring for the ILOGMGR
Tandem Logon Manager for IBM Systems (ILOGMGR) Manual—127335 3-5
Using a CTLOUT Data Set
Control File Example
The following is an example of an ILOGMGR control file:
* The following statement specifies ILOGMGR VTAM APPL name:
ILOGMGR=ibm1
* The following statement identifies a SNAX/APN logon manager
* and two Tandem applications that can be logged on to:
TLOGMGR=tn1,TDMAPPLS=(tcl1,tcl2)
* The following statement identifies a second SNAX/APN logon
* manager and its associated application:
TLOGMGR=tn2,TDMAPPLS=tcl3
* Note that ROUTCDE=, RTIMEOUT=,and RETRYOPEN= are not present *
and will be allowed to default.
Using a CTLOUT Data Set
ILOGMGR messages are displayed by either a write-to-operator (WTO) or
write-to-operator with reply (WTOR) macro. These messages can be routed to various
consoles by using the ROUTCDE control record, or they can be suppressed.
All ILOGMGR messages are written to a user-defined data set if a DD card with a
DDNAME of “CTLOUT” is included in the ILOGMGR execution JCL stream.
If a DD card with a DDNAME of “CTLOUT” is included in the ILOGMGR execution
JCL stream, an OPEN will be attempted. Any OPEN errors cause the ILOGMGR to
display message T0300 on the operator’s console and to disable the logging of
ILOGMGR messages to the CTLOUT data set. See Appendix A, “Error Messages and
Sense Codes,” for information about message T0300.
Once the CTLOUT data set is successfully opened, all ILOGMGR messages are logged
to the data set. If the ILOGMGR encounters an I/O error while logging an ILOGMGR
message, the following events occur:
•
Logging stops.
•
Message T0300 or T0500 is displayed. See Appendix A, “Error Messages and Sense
Codes,” for information about messages T0300 and T0500.
•
A SYNAD or ABEND exit is taken.
•
The data set is closed.
•
ILOGMGR continues processing.
The queued sequential access method (QSAM) processes the CTLOUT data set. Define
the data set with DSORG=PS, MACRF=(PM), and RECFM=FB. You must specify
LRECL and BLKSIZE when the data set is allocated or on the CTLOUT DD statement.
The output buffer is 133 bytes long, and all messages are padded with blanks. Most
messages have fewer than 70 bytes of information. Therefore, you can select an LRECL
and BLKSIZE to suit your needs.