AOCGETCN

Purpose

The AOCGETCN command obtains an extended MCS console with a unique name for an operator or autotask issuing the command. If an MVS console is already associated with that task, it is released.

The default console name is the character A, followed by the last 5 characters of the task name concatenated with the last two characters of the system name.

Syntax

Read syntax diagramSkip visual syntax diagramAOCGETCNparameters

Parameters

Optionally, you may supply one or more parameters that are valid for NetView GETCONID, for example, ALERTPCT, MIGRATE, QLIMIT, QRESUME, or STORAGE.

If you specify more than one parameter, you can either separate them by blank or by comma, for example: 
AOCGETCN MIGRATE=YES,STORAGE=1000
For further information and a list of valid GETCONID parameters and their descriptions, refer to the NetView documentation.

Restrictions and Limitations

The previous console will be released even if AOCGETCN fails to obtain the new console.

The GETCONID parameters CONSOLE=xxxxxxxx and AUTH=yyyyyyy are not supported. If you enter them, they will be ignored.

Usage

Console names within a sysplex must be unique. The task name is used if the console name is not specified. To avoid possible naming conflicts due to common task names AOCGETCN should be used to obtain a console with a unique name. The characters that are used in determining the unique console name can be tailored by updating the common global variable AOFCNMASK. Refer to IBM Z® System Automation Customizing and Programming for further information.

Example

Issue AOCGETCN, for example, in the initial clist of an operator or autotask. As soon as an MVS command is issued by the task, a console is allocated with the console name that has been set by AOCGETCN.

The default name for the console is the character A, followed by the last 5 characters of the task name concatenated with the last two characters of the system name.

Thus, task OPER1 on system FOC1 obtains the default extended console name OPER1. When the AOCGETCN command is issued, the console AOPER1C1 is now associated with OPER1.