Wiki Category: VNC07nn: VNAC Session-Command REXX Execs

msg-line

Informational message issued by LOGTO pipe stage when output to NETLOG is requested by specifying either the NETLOG or ALL operands. LOGTO copies the text of each line from the input message to the agent’s VNCLOG file.

Number of variables found: n

In response to the session command QRYGLOBL type, this message lists the number of global variables found of a given type.

var-namevar-value

In response to the session command QRYGLOBL type, this message lists the name of a VNAC global variable and the first 40 characters of its value.

exec-name: user-id vncout-message

Error messages that explain why the OBEYFILE exec was unable to process agent configuration files or why an activation key could not be processed.
The exec-name is OBEYFILE. It was invoked by user user-id. The possible values of vncout-message are as follows:

config member config-member-name was not processed
config member config-member-name has no valid sections
key has an invalid character activation-key
key is wrong length (actual-key-length) activation-key

exec-name: user-idvncout-message

Informational messages from OBEYFILE exec that explain the disposition of each configuration parameter after it has been processed.

The exec-name is OBEYFILE. It was invoked by user user-id. The possible values of vncout-message are as follows:

activation key activation-key installed
activation key activation-key not installed
activation key activation-key check passed
activation key activation-key check failed
Message Rule message-rule installed
Message Rule message-rule not installed
Message Rule message-rule check passed
Message Rule message-rule check failed
auto start exec exec-name installed
auto start exec exec-name not installed
auto start exec exec-name check passed
auto start exec exec-name check failed
Global Config option global-option installed
Global Config option global-option not installed
Global Config option global-option check passed
Global Config option global-option check failed.

exec-name: user-idvncout-message

Error message issued by OBEYFILE exec while processing configuration statements.

The possible values of vncout-message are as follows:
ActivationKeys section is empty
MessageRules section is empty
AutoStart section is empty
GlobalConfig section is empty
SmfConfig section is empty
duplicate ActivationKeys section skipped
duplicate MessageRules section skipped
duplicate AutoStart section skipped
duplicate GlobalConfig section skipped
duplicate SmfConfig section skipped
invalid statement: configuration-statement.

vncout-message

Informational message issued by multiple VIP session commands, host commands, and REXX functions. The form and content varies with the command and function that generates the message. For details about the following commands and functions, refer to the VNAC Programming & Automation manual or the online help.

The ALTRULE command and ALTRLST function, which report on VNAC alert rules.

The LISTENER command and LSTNRLST function, which report on VNAC commands that listen for console messages.

The LSTGLOBL and QRYGLOBL commands, which report on VNAC global variables.

The MEMBER command and MBRLST function, which report members of a given DD file or dataset.

The MSGRULE command and MSGRLST function, which report on VNAC rules for logging and responding to console messages.

The TASK command and TASKUTIL function, which report on VNAC commands, memory use, and tasks.

The TIMER command and TIMERLST function, which report on scheduled VNAC commands.

The USER command and USERLST function, which report on VNAC requests, sessions, and users.

vncout-message

Error message generated when VNAC is unable to issue a VNAC session command, host command, or REXX function.

One or more VNC0702I messages explaining the cause of the failure may precede VNC0703E.

The values of vncout-message for various execs are as follows. Refer to the VNAC Programming & Automation manual or the online help for information about each exec.

APPS, display menu of VNAC panel applications
ERROR: VIEW-parameter-list failed with return code VIEW-return-code

EMAIL, open panel application for email
ERROR: VNCXEM00-parameter-list failed with return code VNCXEM00-return-code

M, issue any system command
ERROR: system-command failed with return code CONSOLE-return-code

RECYCLE, recycle a VTAM resource
VTAM IST message explaining why vary inact failed
VARY INACTIVE did not complete for RECYCLE VTAM-resource-name
VTAM IST message explaining why vary act failed
VARY ACTIVE did not complete for RECYCLE SNA-resource-name
ERROR: system-command failed with return code CONSOLE-return-code

SEND, write a message to the system console
ERROR: command failed with return code SEND-return-code

SUBMIT, submit a job through the internal reader
ERROR: command failed with return code SUBMIT-return-code

TASK, display task CPU time and memory usage
ERROR: command failed with return code TASKUTIL-return-code

TIMERS, open panel application for timer management
ERROR: VNCXTM00-parameter-list failed with return code VNCXTM00-return-code

VNCPNL, display a no-input panel
ERROR: VIEW-parameter-list failed with return code VIEW-return-code

VNCXEM00, exec for email panel
ERROR: VNCXEM00 failed with return code VNCXEM00-return-code

VNCXTM00, exec for timer-management panel
ERROR: VNCXTM00 failed with return code VNCXTM00-return-code

VNCXTM09, exec to restore timers when agent restarts
Attempt to get timer global variable VNACTIMERtimer-id failed, rc=GLOBALV-return-code
Failed to restore timer timer-id, rc=EXEC-function-return-code
Attempt to delete timer timer-id, rc=GLOBALV-return-code
ERROR: VNCXTM09 failed with return code VNCXTM09-return-code

VSDSF, panel tools for managing the JES spool.
ERROR: VSDSF failed with return code VSDSF-return-code

vncout-message

Informational message issued by several VNAC session commands and REXX execs.

Refer to the VNAC Programming & Automation manual or the online help for information about each session command or exec.

The values of vncout-message that can be generated for various execs are as follows:

ALTRULE, report agent’s processing rules for alerts from VIP.
No active alert filter rules are defined
No inactive alert filter rules were found
No alert filter rules were found

CANCEL, cancel an exec using its command number
Command number command-number was canceled

DEFGLOBL, define a global variable
The current value of global-var-name is null

FILE, show all datset files allocated by the agent
No files found

LISTENER, display commands with console message listeners
No active listeners found

M, issue any z/OS command
No messages received for system-command
No messages received, console session lostcommand-response message
No matching member names found in DD-or-dataset name for search argument search-argument
Error occurred processing DD-or-dataset name

MSGRULE, display the agent’s message logging filter rules
No active message filter rules are defined
No inactive message filter rules were found
No message filter rules were found

QRYGLOBL, display the value of one global variable
The current value of global-var-name is global-var-value

RECYCLE, VTAM recycle an SNA resource
No messages received, console session lost
No messages received
VTAM IST message response to vary inact command
VTAM IST message response to vary act command

SCHEDULE, schedule the execution of a VNAC command
WARNING: OFF-parameter ignored, ON value will be used for AT
WARNING: STOPT-parameter ignored, STARTT value will be used for AT command scheduled

SETGLOBL, set the value of a global variable
The new value of global-var-name is global-var-value

TASK, VNAC display task CPU time and memory usage
No matching tasks found for code task-group-code

TIMER, display active timers
No matching timers found for search string timer-name-with-wildcards

UPDGLOBL, add a numeric value to a numeric global variable
Current value of global-var-name is global-var-value
The new value of global-var-name is global-var-value

USER, display user session statistics
No sessions found

VNCXTM09 exec, restore timers when agent restarts
Found timer timer-id already active during during restore processing
Processing of timer timer-id skipped
Timer timer-id restored
Deleted timer timer-id because RESTORE=N
Deleted timer timer-id because it expired
Summary of timer restore processing
Timers found=timers-found-count
Timers skipped=timers-skipped-count
Timers expired=timers-expired-count
Timers restored=timers-restored-count
Timers removed=timers-removed-count

vncout-message

VNAC parameter syntax error. Or SAW processing status, in the case of session awareness (SAW) execs (SAWSTAT, SAWSTART, SAWSTOP).

Some VNAC session commands and REXX execs display this message to explain parameter syntax errors.

Refer to the VNAC Programming & Automation manual or the online help for information about each session command or exec.

The values of vncout-message they can generate for various execs are as follows:

ACT, VTAM activate resource
ERROR: missing required operand VTAM-resource-name

APPS, panel application, menu of VNAC panel applications
ERROR: APPS must run in an attended session
ERROR: APPS invalid parameter invalid-parameter

CANCEL, cancel an exec using its command number
ERROR: first parameter must be a command number
ERROR: only one parameter allowed for CANCEL
ERROR: command has no parameters
ERROR: command number command-number was not canceled

COS, display VTAM class-of-service information
ERROR: extraneous parameter for APPN
ERROR: extraneous parameter for SUBAREA

CSM, display communications storage manager summary
ERROR: extraneous parameter for CSM: extra-parameter

CSMUSE, display communications storage manager details
ERROR: extraneous parameter for CSMUSE: extra-parameter

D, display MVS-z/OS or VTAM command
ERROR: command has no parameters

DEFGLOBL, define a global variable
ERROR: more than one variable name specified
ERROR: variable name has invalid characters
ERROR: no variable name specified

DELGLOBL, delete a global variable
ERROR: more than one variable name specified
ERROR: no variable name specified

DIS, VTAM display information
ERROR: command has no parameters

DISPLAY, display MVS-z/OS or VTAM command
ERROR: command has no parameters

DROUTE, VTAM display subarea route information
ERROR: command has no parameters

EMAIL, panel application for email
ERROR: EMAIL must run in an attended session
ERROR: EMAIL invalid parameter invalid-parameter

EXCMD, run a command on a different task
ERROR: cannot recursively execute EXCMD
ERROR: command has no parameters

F, z/OS modify command
ERROR: command has no parameters

FILE, show all dataset files allocated by the agent
ERROR: command does not accept any parameters

GVARS, panel application for managing global variables
ERROR: VNXCGV00 invalid parameter invalid-parameter
ERROR: VNXCGV00 must run in an attended session
ERROR: no filter specified, showing variables found with previous filter
ERROR: No filter specified
ERROR: More than one variable selected
ERROR: Invalid action code
ERROR: variable name too long
ERROR: variable values too long
ERROR: VNXGV00 failed with return code

INACT, VTAM vary resource inactive command
ERROR: missing required operand VTAM-resource-name
ERROR: cannot use the FINAL and RMPO operands together

INACTF, VTAM vary resource inactive with force command
ERROR: missing required operand VTAM-resource-name
ERROR: cannot use the FINAL and RMPO operands together

LISTENER, display commands with console message listeners
ERROR: command does not accept any parameters

LISTGLOBL, display name, value, and usage statistics for global variables
ERROR: more than one global variable name specified

M, issue any z/OS command
ERROR: command has no parameters

MEMBER, display PDS members
ERROR: MEMBER only accepts 2 parameters
ERROR: DD name or dataset name is required
ERROR: member name not allowed

MODIFY, z/OS modify command
ERROR: command has no parameters

MSGRULE, display the agent’s message logging filter rules
ERROR: command only accepts one parameter, the rule list option
ERROR: rule list option must be ALL, ACTIVE, INACTIVE, or CLEAR

MVS, issue any z/OS command
ERROR: command has no parameters

NODE, VTAM display information
ERROR: missing required operand VTAM-resource-name

QRYGLOBL, display the value of one global variable
ERROR: more than one variable name specified
ERROR: no variable name specified

QUERYSAW, display the status of data collection for SNA session awareness
SAW processing is enabled and running
SAW processing is enabled and starting
SAW processing is enabled but not running
SAW processing is disabled and not running
SAW processing is disabled and stopping
SAW processing is disabled but running

R, z/OS reply to message
ERROR: command has no parameters
ERROR: first parameter must be a reply number

RECYCLE, VTAM recycle an SNA resource
ERROR: command has no parameters
ERROR: command has more than 3 parameters
ERROR: extraneous parameter for RECYCLE: extra-parameter

REDIAL, VTAM vary line inop command
ERROR: extraneous parameter for REDIAL: extra-parameter
ERROR: missing required operand VTAM-line-name

REPLY, z/OS reply to message
ERROR: command has no parameters
ERROR: first parameter must be a reply number

SCHEDULE, creates timers, schedules commands
ERROR: first argument is not AT or EV: SCHEDULE-parameter-list
ERROR: ID length incorrect: SCHEDULE-parameter-list
ERROR: ID is not alphanumeric: SCHEDULE-parameter-list
ERROR: timer timer-id is already active
ERROR: CMD has no value: SCHEDULE-parameter-list
ERROR: CMD does not start with a letter: SCHEDULE-parameter-list
ERROR: CMD is longer than 128 characters: SCHEDULE-parameter-list
ERROR: STARTD date value incorrect: SCHEDULE-parameter-list
ERROR: STOPD date value incorrect: SCHEDULE-parameter-list
ERROR: ON date value incorrect: SCHEDULE-parameter-list
ERROR: OFF date value incorrect: SCHEDULE-parameter-list
ERROR: STARTT time value incorrect: SCHEDULE-parameter-list
ERROR: STOPT time value incorrect: SCHEDULE-parameter-list
ERROR: INTV time value incorrect: SCHEDULE-parameter-list
ERROR: ON time value incorrect: SCHEDULE-parameter-list
ERROR: OFF time value incorrect: SCHEDULE-parameter-list
ERROR: RESTORE value not Y or N: SCHEDULE-parameter-list
ERROR: unrecognized keyword: unrecognized-keyword
ERROR: required parameter STARTT= is missing
ERROR: required parameter ID= is missing
ERROR: required parameter CMD= is missing
ERROR: required EV parameter INTV= is missing
ERROR: ON cannot be used with STARTD or STOPD
ERROR: OFF cannot be used with STARTD or STOPD
ERROR: ON specified for EV, but OFF is missing
ERROR: ON specified for EV, but STARTT is missing
ERROR: ON specified for EV, but STOPT is missing
ERROR: STOPD date has already expired
ERROR: STOPT time has already expired
ERROR: end date+time is not greater than start date+time
ERROR: failed to execute RUNTMR for timer timer-id

SEND, write message to z/OS console
ERROR: command has no parameters
ERROR: MSG(message text) parameter is required
ERROR: WAIT parameter not allowed with interactive SEND command
ERROR: RESPONSE parameter not allowed with interactive SEND command

SETGLOBL, set the value of a global variable
ERROR: no variable name specified
ERROR: no variable value specified

SAWSTART, start collection of SNA session-awareness data
request has been scheduled
request was previously scheduled and has been completed
request was previously scheduled and is being processed
request was previously scheduled but has not been processed

SAWSTOP, stop collection of SNA session-awareness data
request has been scheduled
request was previously scheduled and has been completed
request was previously scheduled and is being processed
request was previously scheduled but has not been processed

SUBMIT, submit job to the z/OS internal reader
ERROR: command has no parameters
ERROR: only one input file allowed

TASK, VNAC show task status
ERROR: only one task selection code allowed
ERROR: selection code must be 3 characters

TIMER, display active timers
ERROR: only one timer selection code allowed
ERROR: search string must be 1 to 8 characters

TIMERS, timer-management panel
ERROR: TIMERS must run in an attended session
ERROR: TIMERS invalid parameter invalid-parameter

TSOUSER, VTAM display TSO user command
ERROR: missing required operand VTAM-tso-userid

UPDGLOBL, add a numeric value to a numeric global variable
ERROR: no variable name specified
ERROR: no increment value specified
ERROR: no max value specified
ERROR: increment value is not numeric
ERROR: maximum value is not numeric
ERROR: global variable value is not numeric
ERROR: update value would exceed maximum value, or be less than a negative “maximum.” Update skipped.
ERROR: (max-value > 0) && (new-value > max-value)
ERROR: (max-value < 0) && (new-value < max-value)

USER, display user session statistics
ERROR: command only accepts one parameter, the command history count
ERROR: command history count is not a whole number
ERROR: history count must be in the range 1 through 256

V, MVS-z/OS or VTAM vary command
ERROR: command has no parameters

VARY, MVS-z/OS or VTAM vary command
ERROR: command has no parameters

VNCPNL, open a no-input panel.
ERROR: VNCPNL is only valid within a user session
ERROR: incorrect number of parameters
ERROR: application name greater than 8 characters
ERROR: panel name greater than 8 characters
ERROR: panel name not found

VNCXEM00, exec for email panel application
ERROR: VNCXEM00 invalid parameter invalid-parameter
ERROR: VNCXEM00 must run in an attended session
ERROR: panel-name load failed, rc=VIEW-return-code

VNCXTM00, exec for panel application to manage timers.
ERROR: VNCXTM00 invalid parameter invalid-parameter
ERROR: VNCXTM00 must run in an attended session
ERROR: panel-name load failed, rc=VIEW-return-code

VNCXTM09, exec to restore VNAC timers at agent restart
ERROR: VNCXTM09 invalid parameter invalid-parameter
ERROR: VNCXTM09 must run in an attended session

VSDSF, panel tools for managing the JES spool.
ERROR: VSDSF invalid parameter invalid-parameter
ERROR: VSDSF must run in an attended session