FEPI INSTALL TARGETLIST

Description

FEPI INSTALL TARGETLIST defines new targets to FEPI. You can specify an initial service state for these new targets. A target cannot be used for a conversation until it has been put in service, and has been added to a pool so that it is connected to a node. The command completes when the targets have been installed without waiting for the requested states to be achieved.

Options

APPLLIST(data-area)

specifies a contiguous array of 8-character primary logical unit (PLU) names. These are the z/OS® Communications Server application names (APPLID) of the back-end CICS® or IMS systems with which FEPI applications are to communicate; they correspond one-to-one with the target names in TARGETLIST. The names must not contain null characters (X'00'), leading blanks, or embedded blanks. Each name must be unique within the list; duplicate names result in an INVREQ condition being returned.

If a target specified in TARGETLIST is a CICS terminal-owning region that is a member of a z/OS Communications Server generic resource group, you can specify in APPLLIST its generic resource name. This enables you to use the z/OS Communications Server generic resource function to balance sessions across the available TORs. See Workload routing in a sysplex.

SERVSTATUS(cvda)

specifies the initial service state of the targets being defined. All the targets in the list have the same state. The relevant CVDA values are:

INSERVICE

The target is in service and can be used in a conversation.

OUTSERVICE

The target is out of service and cannot be used for any conversation.

TARGETLIST(data-area)

specifies a contiguous array of 8-character target names to be defined. A target name is the logical FEPI front-end name of a back-end system. The names must not contain null characters (X'00'), leading blanks, or embedded blanks. Each name must be unique within the list; duplicate names result in an INVREQ condition being returned.

TARGETNUM(fullword binary data-value)

specifies the number of names in TARGETLIST, in the range 1–256.

Conditions

INVREQ

RESP2 values:

11

FEPI not installed or not active.

110

SERVSTATUS value not valid.

119

The command failed for one or more items in the list.

130

TARGETNUM value out of range.

164

TARGET name not valid.

167

Application name not valid.

174

TARGET name already exists.

177

Application name already exists.