NET-OPER

File 15
Statement FIND / PROCESS
Task Issue VTAM commands and retrieve VTAM messages. Note that commands and messages are not logged to the system console.

Fields

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
840 VTAM operator ACB is not open.
841 VTAM error in SENDCMD.
842 Invalid VTAM command.

Field Descriptions

Field Name Type/Length
COMMAND (A80)

VTAM command.

Field Name Type/Length
LINE (A126)

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
LINE-LENGTH (N3)

Length of output line.

Field Name Type/Length
LINE-STATUS (A3)

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
NUMBER-OF-TOKENS (N3)

Number of tokens in line.

Field Name Type/Length
PURGE-PREVIOUS (A3)

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
TERMINATE-TIME (N5)

Terminate processing loop if no real lines have been returned within the specified period. The default is 60 seconds.

Field Name Type/Length
TIME-STAMP (A8)

The time the message was received from VTAM in the format: HH:MM:SS.

Field Name Type/Length
TOKEN-n (A15)

Tokens 1 to 20. These are returned in a multiple field (20 tokens of 15 bytes each).

Field Name Type/Length
TOKENS (A15)

Tokenized VTAM output line (20 tokens with a length of 15 bytes each), see field TOKEN-n.

Field Name Type/Length
TOKEN-VECTOR (A225)

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.