The GENERATE PASSWORD command- available on password-generating systems only - automatically generates a suggested new password.
Syntax
- -GENERATE - - -PASSWORD - - - 1
Explanation
The GENERATE PASSWORD command can be used only on a password-generating system. A password-generating system has a program that generates passwords for you. If you are on a password-generating system, you cannot make up your own password; you must use a password generated by the system.
The GENERATE PASSWORD command causes the system to generate a password and display it on the bottom of your screen. If you are dissatisfied with the generated password, you can generate another one. You can then either access the CHGPASS screen or use the PASSWORD command to change your password to the new one generated by the system.
See "SHOW PASSWORD" later in this section for information on displaying the system-generated password.
For more information on password security, see the A Series Security Features Operations and Programming Guide.
HELP (Display Help Text)
Using Commands
LANGUAGE (Change Language Specification)
The LANGUAGE command enables you to change the name of the COMS application session language - the language COMS associates with your station for this session.
Or, you can use this command to change the MARC session language - the language MARC associates with your station for this session - or to change both session languages. The command can also list the names of both session languages.
Specifically, you can use this command for either of two purposes:
• To display the current COMS application session language and the current MARC session language
• To define a new language to be used as the COMS application session language, the MARC session language, or both
Syntax
- LANGUAGE - - - . - - - r - - - I
L;
<1 anguage nameJt=~
Explanation
This command displays or changes the MARC session language, the COMS application session language, or both.
LANGUAGE
Displays the MARC session language and the COMS application session language.
LANGUAGE.
Potentially changes the MARC session language, the COMS application session language, or both to the default language for the system.
The command changes the MARC session language if the default language for the system has been bound to MARC by the Message Translation Utility (MSGTRANS).
If that language has not been bound to MARC, the MARC session language remains unchanged.
The command changes the COMS application session language if the command is entered from the MARCil dialogue. If the command is entered from any dialogue other than MARCil, the COMS application language remains unchanged.
LANGUAGE *
Potentially changes the MARC session language, the COMS application session language, or both to the default language for your usercode.
Using Commands
The command changes the MARC session language if the default language for your usercode has been bound to MARC by the Message Translation Utility (MSGTRANS).
If that language has not been bound to MARC, the MARC session language remains unchanged.
The command changes the COMS application session language if the command is entered from the MARCil dialogue. If the command is entered from any dialogue other than MARC/I, the COMS application language remains unchanged.
LANGUAGE <language name>
LANGUAGE = <language name>
Potentially changes the MARC session language, the COMS application session language, or both to the named language.
The command changes the MARC session language if the named language has been bound to MARC by the Message Translation Utility (MSGTRANS). If that language has not been bound to MARC, the MARC session language remains unchanged.
Note: Changes in the system default language or the default language for your usercode have no effect on sessions currently in progress.
For information on using MSGTRANS to bind a language to MARC, see Section 9,
"Using MARC Internationally."
Table 6-1 summarizes the languages referenced by those formats of the LANGUAGE command that are intended to change the MARC session language, the COMS application session language, or both. See the preceding discussion for details on each format.
Table 6-1. LANGUAGE Command Formats
Format Language Referenced
LANGUAGE. Default language for the system
LANGUAGE * Default language for your usercode
LANGUAGE <language name> Named language LANGUAGE = <language name> Named language
Table 6-2 summarizes the ways you can enter a LANGUAGE command to accomplish a particular goal.
Using Commands
Table 6-2. LANGUAGE Command Goals
Goal
When you use the LANG UAG E command to change the MARC session language, MARC first determines whether messages for the named language have been bound to the MARC software. MARC examines one specific message - message 0 of the file *SYSTEM/MARC/COMMANDER, the file that is the main body of MARC - to determine if that message has been translated into the indicated language. This message reads "ok" in the original English version supplied by Unisys.
If MSGTRANS has been used to translate this message, the indicated language becomes the MARC session language. (MARC can determine whether the message has been translated even if the translation is identical to the original.) All MARC messages for this dialogue are then selected using the new MARC session language.
If this message has not been translated, MARC assumes that no messages have been translated. MARC retains the language currently in use as the MARC session language.
If the search for translated messages is successful, MARC then looks for a menugraph file in the indicated language.
This file must have a title of the following form:
SYSTEM/MARC/MENUGRAPH/<language name>
This file must be located on the same family as the MARC code file.
If translated messages are found but the menugraph file is not, MARC adopts the system default menugraph as the menugraph to be used for the indicated language.
Once the default menugraph has been adopted for a language, it is used whenever that language is requested until COMS is reestablished, even if the appropriate menu graph file is later added on the family. In this situation, MARC messages appear in the requested language, but the screens presented are in the default language for the system.
Using Commands
If the appropriate menugraph file and translated MARC messages are both available when the LANGUAGE command is entered, that menugraph file becomes the MARC session language menugraph, and the translated versions in the named language are used for all MARC messages. Online documentation is drawn from the help books associated with the menu graph file.
Effects of the LANGUAGE Command on Screens
When you use the LANGUAGE command to change the language during a MARC session, all the previous screens stored by MARC are purged and you cannot use the PRev action to redisplay screens originally displayed in the former language. However, the system stores the previous screens in the following situations:
• The LANG UAG E change is unsuccessful.
• The new language specified is the same as the language that is currently active.
Note: For additional information on the LANGUAGE command, see Section 9, "Using MARC Internationally."
LIST (List a File)
The LIST command lists the contents of a file.
Syntax
- LIST -<file title>·~---,---7
C=<sequence number>~
_7-.---~---7
L @ -<start col umn> L ~
- -<end column>~
_7-.---~---~1
L : 1f-
COMPRESS - - - . ,I
IRELA TI VE - - - j
SQUASH - - - 1 TRUNCATE - - - j
UPCASE - - - /
<sequence number
control>-<file title>
-<fil e n a m e > · - - . - - - . - - - l
c=
ON -<family name>~<file name>
( / - - - .
Using Commands
<sequence number control>
Explanation
This command lists all or part of a file. Program source files, printer backup files, and files of type SEQ and TEXT are the most suitable for listing with this command. Other file types might contain control characters that affect the operation of your terminal.
The file title can begin with a usercode within parentheses or with an asterisk (*) and must match an existing file title. The file title can also include family names.
LIST <file title>
LIST <file title> <sequence number>
Displays the contents of the specified file. The optional <sequence number> construct specifies the record number at which the display is to begin.
@ <start column>
@ <start column> - <end column>
If you want to display only some of the columns, the start-column option enables you to specify the first column to be displayed, and the end-column option enables you to specify the last column to be displayed. If you omit the end-column value, the last column of the record is assumed, unless you use the TRUNCATE option, as explained later in this discussion. Column numbers can range from 1 to 180.
Example
To display columns 50 through 72 of the file FILEA, enter the following LIST command:
LIST FILEA @ 50-72
Additional Options of the LIST Command
LIST provides the following options that manipulate the text displayed on the screen:
• COMPRESS
• RELATIVE
• SQUASH
• TRUNCATE
• UPCASE
• UNSEQUENCE or SEQWIDTH
A colon (:) must precede a list of one or more of these options.
Using Commands
These options operate as follows:
• COMPRESS
Displays only one blank line between lines of text even if the source file has more than one blank line between text lines. This option deletes the blank lines in the display only; blank lines in your file are unaffected. If you enter a LIST command without this option, the file listing on the screen includes all the blank lines in the file.
• RELATIVE
Causes MARC to use a relative numbering system to access your file. In a file with relative numbers, each line is numbered sequentially by increments of 1, with the first line in your file displayed as relative line number 1. Relative line number 500 is thus the 500th line of the file regardless of its sequence number.
If you enter a LIST command without the RELATIVE option, MARC accesses the file by sequence number. Use UNSEQUENCE to display your file without sequence numbers.
• SQUASH
Reduces any group of mUltiple blanks on a line to a single blank. For example, if your file has more than one blank between words, the file is displayed with only one blank between each word. This option deletes the blanks in the display only;
blanks in your file are unaffected. If you enter a LIST command without this option, the display includes all the blank characters in the file.
• TRUNCATE
Displays only one line for each record. If you enter a LIST command without this option, records longer than the display width normally wrap around onto the next line of the display. The TRUNCATE option eliminates from the display the portion of the record that would otherwise wrap around.
To display a file that is more than 80 columns wide, set this option to avoid line wraparound. Use the COL action on the subsequent display to increase your start column setting to list the truncated part of your file. In this way, you can scroll horizontally to the right to view your file. To scroll left, use COL to set the start column setting back to 1. To remove sequence numbers from the first few columns, set the UNSEQUENCE option.
• UPCASE
Displays the file in all uppercase letters. If you enter a LIST command without the UPCASE option, MARC displays the file without altering the case of the letters.
This option changes the casing of lowercase letters in the display only; the casing in your file is unaffected.
Using Commands
• UNSEQUENCE or SEQWIDTH
These options concern the appearance of sequence numbers in the listing. A LIST command can include either UNSEQUENCE or SEQWIDTH, but not both. The options operate as follows:
UNSEQUENCE displays text without sequence numbers, to provide more space on the screen for display. If you enter a LIST command that does not include this option, text appears to the right of a sequence number that is generated for the LIST command and might not be part of the file.
SEQWIDTH controls the width of field in which sequence numbers appear.
With this option, you specify either an integer between 1 and 8 or ALL. ALL is the default value. Specifying an integer defines the sequence number field
~dth - that is, the number of characters to be allocated at the beginning of each line for the sequence number. When the value of the option is ALL, the system determines the sequence number field width according to the value of the FILEKIND file attribute of the file being displayed. That is, the sequence number field width equals the number of character positions required to accommodate the largest possible number for that FILEKIND.
For information about the FILEKIND file attribute, see the A Series File Attributes Programming Reference Manual.
The default value for each LIST command option is FALSE, with one exception: the default value of the SEQWIDTH option is ALL. To invoke a LIST command option, you need only name that option in the command, again with one exception: the SEQWIDTH option includes an optional equal sign (=) and an integer between 1 and 8 to define the number of character positions to be used for displaying sequence numbers.
Example
The following command requests a listing of FILEB with the COMPRESS option set to TRUE - that is, with only a single blank line between lines of text - and with sequence numbers in a 5-character field:
LIST FILEB :COMPRESS,SEQWIDTH=5
Displaying Printer Backup Files
To display printer backup files, you can use either the LIST command or the Backup Processor utility.
You can run the Backup Processor utility from the PS menu in MARC. The Backup Processor Utility is described in the A Series Printing Utilities Operations Guide.
If you use the LIST command, you can determine the file names of your backup files by using the BDIR command, described earlier in this section. When viewing printer backup files through LIST, you can use the TRUNCATE and UNSEQUENCE options, and the COL action.
Using Commands
MENU (Update Menugraph Version)
The MENU command displays the titles of the active menugraphs for the current session. See "Displaying the List of Active Menugraphs" in Section 8, "Creating Custom Versions of MARC," for details on the use of this command.
MSC (Message Control)
The MSC command enables you to activate the A Series message suppression feature.
With this feature, you can control the display of system messages at the system ODT and at remote terminals. This command is especially useful if your site runs jobs that produce repetitive ODT or terminal messages. You can, for example, simplify ODT and remote terminal display by suppressing announcements of each successful completion of a library maintenance file copy operation.
You can use the MSC command only if your usercode has SYSTEMUSER status. See Section 7, "Controlling System Security," for more information on security privileges.
By default-that is, when the message suppression feature is inactive-the system displays system messages as follows:
• Messages resulting from jobs initiated at the ODT appear on the ODT screen.
• Messages resulting from jobs initiated at a remote terminal- that is, a terminal connected to the system by data comm lines - appear on the screen of that terminal and on the ODT screen.
With the MSC command, you can dynamically suppress or display system messages by identifying
• A type of message, such as warning messages
• A unique message characteristic, such as a specific mix number, task name, or usercode that identifies the job or jobs producing the messages to be suppressed or displayed
Note: Unisys recommends that you specify a characteristic other than a chargecode as the characteristic to be identified. While other message characteristics are single names of up to 17 characters, chargecodes can be multilevel names.
In addition to controlling which messages are displayed or suppressed, an MSC command can control where the suppression or display action occurs:
• At the ODT
• At remote terminals
Using Commands
Specifically, the MSC command enables you to perform the following message control operations:
• Display the currently active MSC commands.
• Suppress the display of messages either on the ODT or on the remote terminal, or on both.
• Reactivate the display of some or all previously suppressed messages.
• Dynamically suppress or reactivate the display of messages based on specified message characteristics such as the usercode under which the job or jobs producing the messages are running, or the message ID of a specific message type.
• Temporarily suspend all active MSC commands and later reactivate those commands to resume message suppression.
• Clear all active MSC commands.
• Store one or more MSC commands as an MSC command file.
• Save the current active list of MSC commands as an MSC command file.
• Define an MSC command file as the file to be loaded automatically after a halt/load.
• Load MSC command files manually as needed.
The A Series System Operations Guide also provides information on the message suppression feature.
Syntax
-- MSC ~---~--~-l
<type>
I - SUPPRESS <type>-- AT --<desti nati on>-r- SHOW ~ L REMOTE -'
Using Commands
<destination>
t
ODT MCS ALLj
<file title>
--<file name>-.---.---~
[ ON --<family name>]
<file name>
r~
/ ---,
/12\--r<name cons tant>----I-r-....l.---~
t= i
--<usercode>-- )-J
L- # --<string primary>~Many MSC command variables - that is, items enclosed in angle brackets « » in the command syntax-can include "wild-card" characters. Wild-card characters are symbolic characters taken to indicate that any character or sequence of characters can appear in the corresponding position or positions in the command.
Wild-card characters are valid in the following MSC command variables:
• Variables used to identify a message type: chargecode, task name, usercode, message ID
• Variables used to identify the source of a message ID: chargecode, task name, usercode
You can use the following wild-card characters in MSC commands:
Character
= (equal sign) (tilde)
? (question mark)
Meaning
Match any sequence of characters.
Match any sequence of characters excluding the slash (J) file node separator.
Match any individual character.
The wild-card mechanism enables to you perform pattern matching-that is, to instruct the system to search for messages that contain one or more common elements of a given message characteristic. For example, the following command suppresses all display of all messages from any job that has a chargecode value in which the fourth digit is 9:
MSC SUPPRESS CHARGE ???9 AT ALL
Similarly, since all warning message IDs consist of the characters MSRWARNG
Using Commands
Explanation
The MSC command enables you to control the display or suppression of system messages.
For details on type and destination specifications, see "Suppressing and Showing Messages" later in this discussion. For details on files of MSC commands, see
"Creating and Using MSC Command Files" later in this discussion.
Note: The MSC command permits the suppression of messages that warn of potentially disastrous situations such as errors in copying during a backup operation, or disk errors during a file copy operation. Be aware of this possibility when you and your operators decide which
Note: The MSC command permits the suppression of messages that warn of potentially disastrous situations such as errors in copying during a backup operation, or disk errors during a file copy operation. Be aware of this possibility when you and your operators decide which