| File | 15 |
|---|---|
| Op-Sys | z/OS, z/VSE |
| Statement | FIND / PROCESS
|
| Task | Issue VTAM commands and retrieve VTAM messages. Note that commands and messages are not logged to the system console. |
| Dictionary Field Name | F/L | Mu | DE | Remarks |
|---|---|---|---|---|
ERROR-CODE
|
N3 | |||
ERROR-TEXT
|
A58 | |||
NODE
|
N5 | D | ||
NODE-NAME
|
A16 | D | ||
COMMAND
|
A80 | D | Required. | |
LINE-LENGTH
|
N3 | D | ||
LINE
|
A126 | D | ||
LINE-STATUS
|
A3 | D | ||
PURGE-PREVIOUS
|
A3 | D | ||
TIME-STAMP
|
A8 | D | ||
TERMINATE-TIME
|
N5 | D | ||
TOKEN-VECTOR
|
A225 | D | ||
NUMBER-OF-TOKENS
|
N3 | D | ||
TOKENS
|
A15 | M20 | D | See fields
TOKEN-n.
|
TOKEN-1
|
A15 | D | ||
TOKEN-2
|
A15 | D | ||
TOKEN-3
|
A15 | D | ||
TOKEN-4
|
A15 | D | ||
TOKEN-5
|
A15 | D | ||
TOKEN-6
|
A15 | D | ||
TOKEN-7
|
A15 | D | ||
TOKEN-8
|
A15 | D | ||
TOKEN-9
|
A15 | D | ||
TOKEN-10
|
A15 | D | ||
TOKEN-11
|
A15 | D | ||
TOKEN-12
|
A15 | D | ||
TOKEN-13
|
A15 | D | ||
TOKEN-14
|
A15 | D | ||
TOKEN-15
|
A15 | D | ||
TOKEN-16
|
A15 | D | ||
TOKEN-17
|
A15 | D | ||
TOKEN-18
|
A15 | D | ||
TOKEN-19
|
A15 | D | ||
TOKEN-20
|
A15 | D |
| Code | Text | z/OS | z/VSE |
|---|---|---|---|
| 840 | VTAM operator ACB is not open.
|
X | X |
| 841 | VTAM error in SENDCMD.
|
X | X |
| 842 | Invalid VTAM command. | X | X |
| Field Name | Type/Length | Operating System |
|---|---|---|
COMMAND
|
(A80) | z/OS, z/VSE |
VTAM command.
| Field Name | Type/Length | Operating System |
|---|---|---|
LINE
|
(A126) | z/OS, z/VSE |
Output line from VTAM. This line is split into segments, known as
tokens. The field NUMBER-OF-TOKENS contains the token count, the
TOKEN-1 to TOKEN-20 fields contain the corresponding
tokens.
| Field Name | Type/Length | Operating System |
|---|---|---|
LINE-LENGTH
|
(N3) | z/OS, z/VSE |
Length of output line.
| Field Name | Type/Length | Operating System |
|---|---|---|
LINE-STATUS
|
(A3) | z/OS, z/VSE |
Line status. Possible values:
| Value | Explanation |
|---|---|
NO
|
No line has been returned. This means that no VTAM messages are currently queued for this user. |
YES
|
A line has been returned. |
| Field Name | Type/Length | Operating System |
|---|---|---|
NUMBER-OF-TOKENS
|
(N3) | z/OS, z/VSE |
Number of tokens in line.
| Field Name | Type/Length | Operating System |
|---|---|---|
PURGE-PREVIOUS
|
(A3) | z/OS, z/VSE |
Action to be performed on messages. Possible options:
| Option | Explanation |
|---|---|
NO
|
The messages for this user are not purged. |
YES
|
Purge any messages queued for this user before issuing a new command. |
| Field Name | Type/Length | Operating System |
|---|---|---|
TERMINATE-TIME
|
(N5) | z/OS, z/VSE |
Terminate processing loop if no real lines have been returned within the specified period. The default is 60 seconds.
| Field Name | Type/Length | Operating System |
|---|---|---|
TIME-STAMP
|
(A8) | z/OS, z/VSE |
The time the message was received from VTAM in the format:
HH:MM:SS.
| Field Name | Type/Length | Operating System |
|---|---|---|
TOKEN-n
|
(A15) | z/OS, z/VSE |
Tokens 1 to 20. These are returned in a multiple field (20 tokens of 15 bytes each).
| Field Name | Type/Length | Operating System |
|---|---|---|
TOKENS
|
(A15) | z/OS, z/VSE |
Tokenized VTAM output line (20 tokens with a length of 15 bytes
each), see field TOKEN-n.
| Field Name | Type/Length | Operating System |
|---|---|---|
TOKEN-VECTOR
|
(A225) | z/OS, z/VSE |
Tokenized VTAM output line (15 tokens of 15 bytes each).
Records are returned in the order that VTAM issues messages.