AUTH


   .-AUTH--=--(--NOACQ--,--NOASDP--,--NOCNM--,--NOPASS--,--NOPO--,--NOTSO--,--VPACE--)-.   
>>-+---------------.-NOACQ-.-----------------------------------------------------------+-><
   '-AUTH--=--(--+-+-------+--+--)-----------------------------------------------------'   
                 | '-ACQ---'  |                                                            
                 | .-NOASDP-. |                                                            
                 +-+--------+-+                                                            
                 | '-ASDP---' |                                                            
                 | .-NOCNM-.  |                                                            
                 +-+-------+--+                                                            
                 | '-CNM---'  |                                                            
                 | .-NOPASS-. |                                                            
                 +-+--------+-+                                                            
                 | '-PASS---' |                                                            
                 | .-NOPO-.   |                                                            
                 +-+------+---+                                                            
                 | +-PPO--+   |                                                            
                 | '-SPO--'   |                                                            
                 | .-NOTSO-.  |                                                            
                 +-+-------+--+                                                            
                 | '-TSO---'  |                                                            
                 | .-VPACE--. |                                                            
                 '-+--------+-'                                                            
                   '-NVPACE-'

statements:

GROUP, APPL

dependencies:

none

Determines whether this application program has the authority to use certain VTAM® functions. You can code these operands in any order. The possible operands are listed below:

AUTH=ACQ

AUTH=NOACQ

Determines whether this application program can use either the OPNDST macroinstruction with the ACQUIRE option or the SIMLOGON macroinstruction. (These macroinstructions enable the application program to initiate a session with a particular logical unit.)

If you code APPC=YES, the default is ACQ. If you code APPC=YES and AUTH=NOACQ, VTAM supplies an override of ACQ and issues a warning message.

AUTH=ASDP

AUTH=NOASDP

Specifies whether an application can supply dial digits (telephone number) and other parameters for a dial-out switched connection during session initiation.

AUTH=CNM

AUTH=NOCNM

Determines whether this application program can use the communication network management (CNM) interface. This interface allows an application program to send and receive formatted request units from certain physical units in the application program’s domain. For more information on the CNM interface, see z/OS Communications Server: SNA Programming.

You must code AUTH=CNM for all application programs for which entries exist in the IBM-supplied CNM routing table or for any user-written applications using the CNM interface. For a complete list of IBM-supplied CNM applications, see z/OS Communications Server: SNA Customization.

AUTH=PASS

AUTH=NOPASS

Determines whether this application program can use the CLSDST macroinstruction with the PASS option to pass session-establishment requests to other application programs.

For more information on the CLSDST macroinstruction, see z/OS Communications Server: SNA Programming.

AUTH=PPO

AUTH=SPO

AUTH=NOPO

Specifies whether the application program can issue VTAM operator commands and receive responses and unsolicited messages. z/OS Communications Server: SNA Programming describes the program operator application.

If you code either the primary program operator (PPO) or the secondary program operator (SPO), the application program is authorized to issue SENDCMD and RCVCMD macroinstructions.

If you code PPO, the application program receives all unsolicited messages, that is, all informational and error messages that are not replies to operator commands. If no PPO-designated application program is active when these messages occur, they are directed to the system console.

AUTH=TSO

AUTH=NOTSO

Specifies whether the application program is a TSO/VTAM time-sharing program. If it is a TSO/VTAM time-sharing program, code TSO. If not, code NOTSO or take the default.

If you code AUTH=TSO, you cannot use wildcard values in the name field of this APPL definition statement.

AUTH=VPACE

AUTH=NVPACE

Determines whether this application program is subject to the VPACING specifications of SLUs with which the program is in session. Coding NVPACE is the same as coding VPACING=0 in the LU definition statements for all of the SLUs with which the application program is in session. NVPACE is ignored for same-domain local SNA logical units.

Note: It is recommended that you code AUTH=NVPACE for normal interactive TSO/VTAM sessions. However, if you have application-to-application TSO/VTAM sessions, it is recommended that you pace them by coding VPACING=20.

For more information on pacing, see the discussion in the z/OS Communications Server: SNA Network Implementation Guide.