NET-OPER

#### Search Results

Search

# NET-OPER

File | 15
Op-Sys | z/OS, z/VSE Note Support for z/VSE is deprecated. Support for BS2000 is also deprecated, except in conjunction with the ESM adapter. Features that are z/VSE and BS2000 specific will be removed from future releases.
Statement | `FIND` / `PROCESS`
Task | Issue VTAM commands and retrieve VTAM messages. Note that commands and messages are not logged to the system console.

## Common Fields for all Operating Systems

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 |

## Relevant Error Codes

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 Descriptions

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).

## Default Order of Data Returned

Records are returned in the order that VTAM issues messages.

### On this page

- Common Fields for all Operating Systems
- Relevant Error Codes
- Field Descriptions
- Default Order of Data Returned