SYNONYM If vou have a synonym table with the file identification USERTAB SYNONYM A, that has the entry:
FILEDEF USENAME 3
then, USENAME is a synonym for FILEDEF, and acceptable truncations of USENAME are: USE, USEN, USENA, USENAM, and USENAME. The user synonym
abbreviation table is available whenever both SET ABBREV ON and SYNONYM USERTAB are specified.
No matter what synonyms and truncations are defined, the full real
name of the command is always in effect.
Figure 20 available for
commands.
lists the forms of the system command and user synonyms
the various combinations of the SET ABBREV and SYNONYM When you enter the SYNONYM command with no operands, the synonym table(s) currently in effect are displayed. SYSTEM COMMAND USER SYNONYM SHORTEST FORM (IF ANY) This response is the same as the response to the command QUERY SYNONYM ALL. DMSSYN
7 11I NO SYSTEM SYNONYMS IN EFFECT This response is displayed when you issue the SYNONYM command with
no operands after the command SYNONYM (NOSTD) has been issued. DMSSYN712I NO SYNONYMS (DMSINA NOT IN NUCLEUS) The system routine which handles SYNONYM command processing is not
in the system. DMSSYN002E FILE 'fn ft fm' NOT FOUND RC=28 DMSSYN003E INVALID OPTION 'option' RC=24 DMSSYN007E FILE 'fn ft fm' NOT FIXED, 80 CHAR RECORDS RC=32 DMSSYN032E INVALID FILETYPE 'ft' RC=24 DMSSYN056E FILE 'fn ft fm' CONTAINS INVALID RECORD FORMATS RC=32 DMSSYN066E 'option AND 'option' ARE CONFLICTING OPTIONS RC=24 DMSSYN104S ERROR Inn' READING FILE 'fn ft fm' FROM DISK RC=100
section 2. CMS Commands 185

SYNONYM r-- -----, I I I Options SET ABBREV ON SYN USERTAB (STD SET ABBREV OFF SYN USERTAB (STD SET ABBREV ON I SYN USERTAB (NOSTDI I I I I I I I , Acceptable
Command
Forms
FI
FIL
FILEDEF USE US EN USENAME FILEDEF USENAME FILEDEF USE USEN USENAME SET ABBREV OFF I FILEDEF SYN USERTAB (NOSTDI USENAME I SET ABBREV ON SYN (CLEAR STD SET ABBREV OFF SYN (CLEAR STD SET ABBREV ON SYN (CLEAR NOSTD SET ABBREV OFF SIN (CLEAR NOSTD I I I I I I I I FI
FIL
FILEDEF
FILEDEF
Comments
The ABBREV ON option of the SET command and the STD option of the SYNONYM command make the system
table available. The user synonym, USENAME, is available
because the synonym table (USERTAB) is specified on the SYNONYM command. The truncations
for USENAME are available because SET ABBREV ON was specified with
the USERTAB also available. IThe user-defined synonym, USENAME, I is permitted because the user I synonym table (USERTAB) is speci­ I fied on the SYNONYM command. No I system or user truncations are I permitted. IThe system synonym table is un- , available because the NOSTD option I is specified on the SYNONYM com- I mand. The user synonym, USENAME, I is available because the user syno­ I nym table (USERTAB) is specified on I the SYNONYM command and the trunca­ I tions of USENAME are permitted , because SET ABBREV ON is specified , with USERTAB also available. IThe system synonym table is made I unavailable either by the SET , ABBREV OFF command or by the SYN , (NOSTD command. The synonym, , USENAME, is permitted because the I user-defined synonym table I (USERTAB) is specified on the , SYNONYM command. The truncations I for USENAME are permitted I because the SET ABBREV OFF option , is in effect. IThe user-defined table is now un­
available. The system synonym
table is available because both
the ABBREV ON option of the SET command and the STD option of the SYNONYM command are specified. IBecause CLEAR is specified on the I SYNONYM command, the synonym and I its truncations are no longer , available. Either the SET ABBREV I OFF command or the SYNONYM (NOSTD I command make the system synonym I table unavailable. I Figure 20. System and User-Defined Truncations
186 VM/3 7 0 eMS Command and Macro Reference I I I