| File | 35 |
|---|---|
| Statement | FIND, PROCESS
|
| Task | Read operator console or issue console commands. |
| Code | Text |
|---|---|
| 530 | Access denied by Security Facility. |
| 537 | Time limit reached. |
| 600 | Unknown function. |
| 630 | Console not defined or inactive. |
| 750 | Invalid operand within operand list. |
| 799 | Entire Systems Management Adapter internal error. |
| 809 | Subsystem not active. |
| 986 | No or not enough space for COMMAND IN MP.
|
| Dictionary Field Name | Format/
Length/ Desc/Mu |
Description |
|---|---|---|
| FUNCTION | (A8) | Required. Function to be performed. |
| D | Possible values: | |
| DISPLAY Display console screen image. | ||
| DIS-WTOR Display pending operator replies. | ||
| OP-CMD Issue operator command. | ||
| WTO Write to operator. | ||
| WTOR Write to operator with reply. | ||
| JOB-ID | (A8) | Relevant with FUNCTION=DISPLAY, DIS-WTOR. |
| D | Job number (TSN) of job for which the message was created. | |
| JOB-NAME | (A8) | Relevant with FUNCTION=WTOR. |
| D | Only relevant for the function DIS-WTOR or DISPLAY. The job for which the console message was created if the job is still active. | |
| JOB-TYPE | (A6) | Relevant with FUNCTION=DISPLAY, DIS-WTOR. |
| D | Only relevant for function DISPLAY and DIS-WTOR. Type of job for which message was created, if this job is still active. | |
| NETTO-TEXT | (A253) | Relevant with FUNCTION=DISPLAY, DIS-WTOR. |
| D | Only relevant for function DISPLAY and DIS-WTOR. Message text without the additional information added by the Operating System at the creation of the console message. | |
| NETTO-TEXT-PART2 | (A3) | Bytes 254 - 256 of the NETTO-TEXT. |
| D | ||
| READ-DIRECTION | (A1) | Relevant with FUNCTION=DISPLAY. |
| D | Only relevant for function DISPLAY. Direction for reading console messages. Possible values: | |
| B Default. Backwards (that is, towards oldest message). | ||
| F Forwards (that is, towards message last received). | ||
| The starting position of READ-DIRECTION can be specified in the RECORD-NUMBER field. | ||
| RECORD-NUMBER | (N9) | Relevant with FUNCTION=DISPLAY. |
| D | The number of the console message is returned in this field. If used as input (descriptor), a start position can be given. Possible values: | |
| 0 Start with latest record. | ||
| n Start with record n. | ||
| -n Start with latest record minus n records. | ||
| If the last record + 1 is selected and the value of the field WAIT-TIME is greater than 0, the system waits for the next message. | ||
| If the specified start position lies before the oldest available record, the oldest record is taken as the start position. | ||
| REPLY | (A80) | Relevant with FUNCTION=DIS-WTOR. |
| D | Only relevant for function WTOR: the operator reply. | |
| REPLY-FLAG | (A1) | Relevant with FUNCTION=DISPLAY, DIS-WTOR. |
| Possible values: | ||
| N Message requires no reply. | ||
| Y Message requires a reply. | ||
| REPLY-ID | (A8) | Relevant with FUNCTION=DIS-WTOR. |
| D | Only relevant for function DIS-WTOR. The identifier which must be used to reply to a write-to-operator-with-reply. | |
| TEXT | (A253) | Relevant for function OP-CMD, default length: 80 characters. The command to be entered for function OP-CMD (operator command), default length = 80 characters. |
| D | ||
| TEXT-PART2 | (A3) | Bytes 254 - 256 of the text line. |
| D | ||
| TEXT-LENGTH | (N3) | Relevant for function OP-CMD, maximum value = 120. |
| D | Length of field TEXT, maximum value = 120 characters. Note that using this field an operator command can exceed the default lenght (80 characters) up to a maximum length of 120 characters. | |
| TIME-STAMP | (A8) | Time stamp of the console message in format HH:MM:SS. |
| D | ||
| TIMX | (T) | Relevant with FUNCTION=DISPLAY. |
| D | Time stamp in Natural internal format. | |
| WAIT-TIME | (B4) | Only relevant for function DISPLAY. Time in seconds to wait for the next message (see also the field RECORD-NUMBER). If no message arrives within the specified time, ERROR-CODE 537 is issued. |
| D |
The default length of a command line is 80 characters. However, it can be expanded up to 120 characters if field TEXT-LENGTH is accordingly specified as displayed in the following sample code for function OP-CMD:
PROCESS CONSOLE USING NODE = #NODE , FUNCTION = 'OP-CMD' , TEXT = #COMMAND-LINE , TEXT-LENGTH = 120 GIVING ERROR-CODE ERROR-TEXT
The functions DISPLAY, DIS-WTOR and OP-CMD require that the UCON interface task of the Entire Systems Management Adapter is active.
Messages are returned in timestamp order (oldest to newest).