SNACONS Customization

The SNACONS customization module (SNAUSER) contains the default command authorities and routing codes for SNACONS consoles.

The customization module can also contain an optional list of terminal names which are exempt from RACF signon. By specifying LOGAPPL=SNACONS in the VTAM definitions for these terminals, you can have consoles automatically logged on to SNACONS without operator intervention.

The customization job

To alter the customization module, download the job SNACCUST.JCL to your PC, edit the SNAOPER customization statements as required, then submit the job to your OS/390 system. The job will assemble the customization module and relink the SNACONS load module.

Customization statements

SNAOPER TYPE=INITIAL

This statement must be at the start of the SNAUSER module.

SNAOPER TYPE=DEFAULT

This statement must be present. It defines the default command authorities and routing codes. See below for the additional parameters which can be specified on this statement.

SNAOPER TYPE=NOSIGNON,NETID=netid,LUNAME=luname

One or more of these statements may optionally be specified. Each statement defines the SNA network identifier and LU name of a terminal which is exempt from RACF signon. The terminal is signed on automatically when it connects to SNACONS, and runs under the RACF id of the SNACONS started task. By using the VTAM LOGAPPL facility you can have the terminal activate itself as a SNACONS console without operator intervention. Additional parameters define the command authorities and routing codes for the terminal, as described below.

SNAOPER TYPE=FINAL

This statement must be at the end of the SNAUSER module, and must be followed by an assembler END statement.

Parameters for TYPE=DEFAULT and TYPE=NOSIGNON statements

AUTH=MASTER | ALL | INFO | (SYS,IO,CONS)

This parameter defines the MVS command authorities for the console. Possible values are:

• AUTH=MASTER allows all commands including those requiring master console authority.
• AUTH=ALL allows all commands except those requiring master console authority.
• AUTH=INFO allows only information display commands.
• AUTH=SYS allows commands in the MVS system control class.
• AUTH=IO allows commands in the MVS I/O control class.
• AUTH=CONS allows commands in the MVS console control class.

More than one class out of SYS, IO, and CONS may be specified. Multiple classes must be separated by commas and surrounded in parentheses. ALL is equivalent to (SYS,IO,CONS). MASTER, ALL, and INFO cannot be specified with any other class.

MFORM=(T,J,S) | M

This parameter defines the message identifiers that are displayed on the console. Possible values are:

• MFORM=T displays messages with timestamps.
• MFORM=S displays messages with the originating system identifier.
• MFORM=J displays messages with job numbers.
• MFORM=M displays messages only, without timestamps, system identifiers, or job numbers.

More than one value out of T, S, and J may be specified. Multiple values must be separated by commas and surrounded in parentheses. M cannot be specified with any other value.

LEVEL=(R,I,CE,E,IN,BC) | ALL

This parameter defines the types of message that are displayed on the console. Possible values are:

• LEVEL=R displays messages requiring a reply.
• LEVEL=I displays immediate action messages.
• LEVEL=CE displays critical eventual action messages.
• LEVEL=E displays eventual action messages.
• LEVEL=IN displays informational messages.
• LEVEL=BC displays broadcast messages.
• LEVEL=ALL displays all messages.

More than one value out of R, I, CE, E, IN, and BC may be specified. Multiple values must be separated by commas and surrounded in parentheses. ALL cannot be specified with any other value.

MONITOR=(JOBNAMES[T],SESS[T],STATUS)

This parameter defines which types of system status messages are displayed on the console. Possible values are:

• MONITOR=JOBNAMES displays job started and ended messages.
• MONITOR=JOBNAMEST displays job started and ended messages with timestamps.
• MONITOR=SESS displays TSO session started and ended messages.
• MONITOR=SESST displays TSO session started and ended messages with timestamps.
• MONITOR=STATUS displays dataset status messages.

More than one value may be specified. Multiple values are separated by commas and surrounded in parentheses.

ROUTCDE=(code,code,...) | ALL | NONE

This parameter defines the routing codes for the console. Only messages with matching routing codes are displayed on the console. Possible values are:

• ROUTCDE=(code,code,...) specifies a list of routing codes. Each routing code is a decimal number in the range 1 to 128, or a range of routing codes in the form code-code.
  For example, ROUTCDE=(1,3-6,12,15,21-128)
• ROUTCDE=ALL specifies all routing codes.
• ROUTCDE=NONE specifies no routing codes.

Multiple values must be separated by commas and surrounded in parentheses. ALL and NONE cannot be specified with any other value.

CMDSYS=sysname

This parameter defines the name of the system which will process commands entered at this console in a sysplex environment.

MSCOPE=(sysname,...) | *ALL

This parameter defines the names of the systems whose messages will appear on the console in a sysplex environment, or *ALL if the console is to receive messages from all systems. Multiple values must be separated by commas and surrounded in parentheses. *ALL cannot be specified with any other value.

UD=YES | NO

This parameter defines whether or not this console is to receive messages which are otherwise undeliverable.

AUTO=YES | NO

This parameter defines whether or not this console is to receive messages which are flagged as automation messages.

HC=YES | NO

This parameter defines whether or not this console is to receive messages which are flagged as hardcopy messages.

For more information, refer to the OS/390 MVS Planning: Operations manual.

---