Previous Topic: ALLOCATE Command (CASRV)Next Topic: CANCEL Command (CASRV)

Address Space › Common Address Space Shell › CASRV Operator Commands › ATTACH Command (CASRV)

ATTACH Command (CASRV)

The ATTACH command starts a CA product or component in the Common Address Space Shell (CASRV).

Syntax

ATTACH SERVER=servername,PGM=pgm [,DDNAME=tasklib] [,PARMDD=parmdd] [,MEMBER=parmmember] [,EXECPARM=parms_for_pgm]

Parameters

SERVER=

A 1- to 17-character string of the form servername.qualifier

The servername is a 1- to 8-character name of the CA product or component to be started in the CASRV. If a qualifier is specified, it must be a 1- to 8-character string and must be separated from the servername by a period (“.”). The qualifier is the command qualifier or shortcut for entering commands.

Neither the servername nor the qualifier may contain a period. Neither the servername nor the qualifier can be the string “SRV”.

Both are uppercase.

If a qualifier is not specified, the servername is used.

Example:

Assume SERVER1 registers a DISPLAY command.

If no qualifier is specified, issue:

DISPLAY SERVER1 operands

If a qualifier was specified, (for example, “ATTACH SERVER=SERVER1.X”), issue:

DISPLAY X operands

Or

DISPLAY SERVER1 operands

PGM=

1- to 8-character program name to attach as the job-step task program for the CA product or component server.

DDNAME=

(Optional) DDNAME of library to be used as a TASKLIB for the CA product or component being started.

PARMDD=

(Optional) DDNAME of data set or path to be used to retrieve parameter statements for the CA product or component being started.

If omitted, the DDNAME of CASVPARM is used.

If the DDNAME of CASVPARM is not allocated, parameters are retrieved from the system logical PARMLIB data sets.

MEMBER=

(Optional) PDS(E) member name containing parameter statements for the CA product or component being started. There is no default member name.

EXECPARM=

(Optional) 1- to 100-character parameter string to be passed to the CA product or component being started as an execute parameter. To preserve case, enclose any string in single quotes.