Function
Enables the operator and system jobs to send messages of their own choosing to the System Journal.
Format
SJMESS parameter list
Where the parameters in the parameter list may be any of the following:
| Parameter | Comments | Example | |
|---|---|---|---|
| C (action on monitoring file) | For a description of the action on monitoring file parameter, see the TRACE command. JOURNAL and ONLINE categories are supplied by GEORGE, and bit 3 of the category word is also set if a PDC list is given. This parameter must be supplied. | C(LG,ENGINEER) | |
| J number | This provides the jobnumber part of the message. If the number is -1, or is omitted, the job's own number (zero if operator) is supplied by GEORGE. Any positive 24-bit number is permitted and J0 is used for no jobnumber. This parameter must be supplied. | J12593 | |
| M number | This provides the message number part of the message. Any 12-bit number is permitted. The number is zero in default if M is specified alone, but this should not be done if a P PDC list parameter is given. This parameter must be supplied. | M73 | |
| P PDC list or P (number list) |
This provides a list of PDCs for a packed message. If one of these is given, GEORGE supplies the PACKED category bit and checks that the message number is non-zero. The PDC list form of the parameter may not contain the PDCs space, comma, quote (") or parentheses. | P:+R P(10,#33,#62) | |
| U | This must be supplied if there is no P parameter in order to indicate an unpacked message. | ||
| AUT or A | This must be supplied to indicate autonomous write to the System Journal if no N or NOW parameter is supplied. | ||
| NOW or N | This calls for s non-autonomous System Joural write (as for PERI type 60 mode #74 extracode). GEORGE initiates a transfer to the System Journal at once instead of waiting for its buffer to be filled with messages and the job issuing the command (extracode) does not continue until the transfer is finished. Only the first effect is relevant in the case of an SJMESS command typed by the operator. | ||
| T enclosed string or TEXT enclosed string |
This provides (part of) the text of the message. The enclosed
string must have parentheses or quotes for delimiters, and
follow the usual rules for such a parameter. Percent signs must be
doubled because of command processor substitution. Any message fragment constructed from this parameter will be space-filled to a whole number of words. |
T(50%% OF JOBTIME USED) | |
| W number | This stores a 24-bit binary number as part of a message. It will start at a word boundary. | W7 |
The parameters may be in any order. The order of the TEXT and W parameters determines the order of the assembled message.
Forbidden contexts
The command must be issued in one of the following contexts:
Execution
A System Journal record is constructed from the parameters given and is written to the Journal. The message from word 3 onwards consists first of a string of PDCs (if a P parameter is specified) extended to occupy a whole number of words, followed by the strings or numbers implied by the T or W parameters, in the order in which they occur.
In the case of packed messages, no checks are made to see that the format of any given parameter data is appropriate to its corresponding PDC, nor that the word count preceeding the parameter data of a 'variable' PDC is sensible. Errors here will only be detected by software reading the Journal.
The negative checksum in the Journal record is appended by GEORGE.
Error Messages
TOO MANY PARAMETERS
z PARAMETER MISSING
INVALID JOBNUMBER
INCORRECT FORMAT FOR PACKED MESSAGES
n IS NOT A VALID NUMBER FORMAT
THE MAXIMUM PERMITTED NUMBER IS n
ERROR IN SJMESS: YOUO DO NOT HOLD SJMESS PRIVILEGE
m IS AN UNKNOWN MONITORING CATEGORY
ALL CANNOT FOLLOW FULLBUT
ALLBUT OR FULLBUT MUSTCOME FIRST