IMFEXEC NetView command processor
The IMFEXEC NetView command processor represents the EXEC link between the
BMC AMI Ops Automation
address space and any NetView system.
The sets the value of the global variable CICSACB in the associated BMC AMI OpsA to ACTIVE. BBI-SS PAS that issues EXEC does not need to be the associated sets the value of the global variable CICSACB in the associated BMC AMI OpsA to ACTIVE. BBI-SS PAS of the target NetView.
With NetView, you can schedule a NetView CLIST, a REXX EXEC, or a command in the target NetView system.
When the NETVIEW command terminates, the IMFCC variable contains one of the following values:
Value | Description |
|---|---|
0 | Command executed successfully |
4 | Sets the value of the global variable CICSACB in the associated BMC AMI OpsA to ACTIVE. for NetView not installed in target or not started |
6 | Partial response returned for a command That is, fewer lines were returned than what the Count() parameter specified. |
8 | Jobname not available or invalid |
12 | Request timed out |
16 | Syntax error in command |
20 | Response to the command was not received and the exit is not active This value could mean the exit is not active in NetView or is installed improperly. |
The syntax for the command is
The parameters for IMFEXEC NETVIEW are described in the following table:
Command | Parameters | Description |
|---|---|---|
NETVIEW | 'command' WAIT(wsec) COUNT(number_of_lines) JOBNAME(jobname) STEM( stem) | Schedules a NetView CLIST, REXX EXEC, or NetView command |
where
Parameter | Description |
|---|---|
' command' | Is any valid NetView command This command must be non-conversational because the EXEC cannot reply to any generated prompts. |
WAIT | Is the number of seconds the EXEC waits for the successful execution of the command. You do not have to wait if the results do not need to be checked. The default is 10 seconds. |
COUNT | Allows you to specify how many lines are expected to be returned to Access NV from the NetView command (or EXEC); valid values are 0 through 79 When you specify COUNT(0), Access NV does not process any responses, thereby returning control to the sets the value of the global variable CICSACB in the associated BMC AMI OpsA to ACTIVE. EXEC more quickly. In addition:
|
JOBNAME | Is the name of a NetView address space where the command is to be issued BMC AMI Ops Automation for NetView must be installed in this address space. If you do not specify the jobname, the default for this command is the jobname specified on the NETVIEW parameter in BBPARM member BBISSP00. |
STEM | (optional) Returns NetView responses in REXX stem TSO variables where the value of stem.0 resolves to the number of lines returned Specify a stem root name for the REXX stem variable by using the following guidelines:
Note: This parameter is valid only for REXX EXECs. If used in a CLIST, an error is returned. If the stem name ends in a period (.), sets the value of the global variable CICSACB in the associated BMC AMI OpsA to ACTIVE. processing ignores the period. For example, specifying STEM(MYVAR.) produces the same result as specifying STEM(MYVAR). Using this parameter overrides the creation of LINEn variables in the LOCAL variable pool. The REXX stem variable is only defined as a TSO variable. If you want to use the stem variables as LOCAL variables, you must first use IMFEXEC VPUT to move them to the LOCAL pool. These REXX stem variables conform to all TSO/E REXX coding standards for stem variables. |
When the request is completed, the sets the value of the global variable CICSACB in the associated BMC AMI OpsA to ACTIVE. variable IMFNOL contains the actual number of lines of output generated by NetView in response to this command. The individual lines are placed into the local variables LINE1 through LINEnn. The current maximum data to be returned is approximately 7000 characters.
For example, issues the NetView MAJNODES command in the NetView address space CNM01.
It allows up to 15 seconds to return the results to the EXEC before timing out.
Related topic