Examples of USS command conversion
- The USS table used
- The format for entering the command
- The converted command
Example 1: Parameters omitted
F NET,TNSTAT
All parameters
are omitted and, therefore, defaults are used during conversion. The
following operation-level USS table is used: USSTAB
USSCMD CMD=TNSTAT,FORMAT=BAL
USSPARM PARM=P1,REP=CNSL,DEFAULT=NO
USSPARM PARM=P2,REP=TIME,DEFAULT=60
USSEND
TNSTAT CNSL(NO) TIME(60)
Example 2: Positional and keyword parameters (FORMAT=PL1)
LOFF(PROG) T(COND)
is
issued. Positional and keyword parameters are used with FORMAT=PL1.
The following session-level USS table is used: USSTAB
USSCMD CMD=LOFF,REP=LOGOFF,FORMAT=PL1
USSPARM PARM=P1,REP=APPLID
USSPARM PARM=T,REP=TYPE,DEFAULT=COND
USSEND
LOGOFF APPLID(PROG) TYPE(COND)
Example 3: Positional and keyword parameters (FORMAT=PL1)
LOFF (PGM) T
is
issued. A null value is taken instead of a default value. Positional
and keyword parameters are used with FORMAT=PL1. The following session-level
USS table is used: USSTAB
USSCMD CMD=LOFF,REP=LOGOFF,FORMAT=PL1
USSPARM PARM=P1,REP=APPLID
USSPARM PARM=T,REP=TYPE,DEFAULT=COND
USSEND
LOGOFF APPLID(PGM) TYPE( )
Because T was coded, the default value specified in the table is not used. If T had not been coded, TYPE(COND) would have resulted. TYPE( ) causes unconditional termination. Note that if you replace DEFAULT=COND with VALUE=COND in the table entry (USSPARM PARM=T,REP=TYPE,VALUE=COND), this command results in a TYPE(COND) instead of TYPE( ).
Example 4: Positional and keyword parameters (FORMAT=BAL)
LON PROGRAM,IN='7,3,JOhn'
is
issued. Positional and keyword parameters are used with FORMAT=BAL. USSTAB
USSCMD CMD=LON,REP=LOGON,FORMAT=BAL
USSPARM PARM=P1,REP=APPLID,DEFAULT=TESTPROG
USSPARM PARM=MODE,REP=LOGMODE,DEFAULT='PROMPT'
USSPARM PARM=IN,REP=DATA
USSEND
LOGON APPLID(PROGRAM) LOGMODE(PROMPT) DATA('7,3,JOhn')
Note that no character translation was performed on JOhn because there were single quotation marks around it. Note also that the single quotation marks around PROMPT in the default declaration have been deleted (by the assembler when the USS table was assembled).
Example 5: Using parameter not defined in USS table
F NET,IMR,ID=PU12,OPT=ACT,RECLIM=200
is
issued. A parameter (ID) is used that is not defined on the USS table. USSTAB
USSCMD CMD=IMR,FORMAT=BAL
USSPARM PARM=OPT,DEFAULT=ACT
USSPARM PARM=RECLIM,DEFAULT=10
USSEND
IMR ID(PU12) OPT(ACT) RECLIM(200)
Because ID is not defined by a USSPARM macroinstruction in the USS table, the keyword is not changed during conversion.
Example 6: Renaming keyword replaced by verb
F NET,XYZ,ID=PU12
is issued. This
example shows how to rename a keyword that is replaced by a verb. USSTAB
*
USSCMD CMD=MODIFY,FORMAT=BAL
USSPARM PARM=XYZ,REP=VERB,VALUE=XYZ
*
USSCMD CMD=XYZ,REP=IMR,FORMAT=BAL
USSPARM PARM=OPT,DEFAULT=ACT
USSPARM PARM=RECLIM,DEFAULT=10
USSEND
VERB(XYZ) ID(PU12)
which in
turn, after the second pass, results in the following converted command
IMR ID(PU12) OPT(ACT) RECLIM(10)
Note that the FORMAT=BAL specification on CMD=XYZ is ignored. After the first pass, VTAM uses the PL/I format for command processing.
Example 7: Using interpret and USS tables
- The interpret table is coded as follows:
XRFINTAB INTAB LOGCHAR APPLID=(USERVAR,ZZIMSUV),SEQNCE='ZZIMS' ENDINTAB XRFINTAB
- The USS table is coded as follows:
XRFUSTAB USSTAB USSCMD CMD=IMS,REP=LOGON,FORMAT=PL1 USSPARM PARM=P1,REP=APPLID,DEFAULT=ZZIMS USSPARM PARM=P2,REP=LOGMODE,DEFAULT=ILOGMODE USSEND END XRFUSTAB
- If the LOGON sequence entered by the terminal user is
IMS,
- The interpret table will be searched for a matching entry, but none will be found.
- The message will be translated, using the information in the USS
table, to read
LOGON APPLID(ZZIMS) LOGMODE(ILOGMODE)
- The interpret table will be searched again, this time using “ZZIMS,” the string specified as the APPLID in the reformatted LOGON message. Because “ZZIMS” does match an entry in the interpret table, the information in that entry will be used. If the current value of the USERVAR ZZIMSUV is “IMS1,” the session will be established to the IMS1 application.
- On the other hand, if the LOGON sequence entered by the terminal user is “ZZIMS,” a match will be found during the initial search of the interpret table; Therefore, the USS table will not be used (the LOGMODE operand specified in the USS table will not be added). The USERVAR specified in the interpret table entry will still be used.
Example 8: Using TRANSLATE=NO to pass a mixed case password, assuming the translation table is used to convert all text to upper case.
app11 user1/PaSsWrD1 interact
is
issued. Positional parameters are used with FORMAT=PL1. The following
session-level USS table is used: AUSSTAB USSTAB
APPL1 USSCMD CMD=APPL1,REP=LOGON,FORMAT=PL1
USSPARM PARM=APPLID,REP=APPLID,DEFAULT=APPL1
USSPARM PARM=P1,REP=DATA,TRANSLATE=NO
USSPARM PARM=P2,REP=LOGMODE
USSEND
LOGON APPLID(APPL1) DATA(user1/PaSsWrD1) LOGMODE(INTERACT)
Example 9: Using the default TRANSLATE=YES to pass a mixed case password, assuming the translation table is used to convert all text to upper case.
app11 'user1/PaSsWrD1'
is
issued. Positional parameters are used with FORMAT=PL1. The following
session-level USS table is used: AUSSTAB USSTAB
APPL1 USSCMD CMD=APPL1,REP=LOGON,FORMAT=PL1
USSPARM PARM=APPLID,REP=APPLID,DEFAULT=APPL1
USSPARM PARM=P1,REP=DATA
USSPARM PARM=P2,REP=LOGMODE
USSEND
LOGON APPLID(APPL1) DATA('user1/PaSsWrD1') LOGMODE(INTERACT)
For further information on converting USS commands, see the z/OS Communications Server: SNA Network Implementation Guide.