Release Remote Phase (RLSRMTPHS)

The Release Remote Phase (RLSRMTPHS) command initiates a session between the iSeries and a System/370 NetView Distribution Manager (NDM) host system. After the phase is released by NDM (or an unsuccessful attempt is made to do so), the session is ended.

The following considerations apply when running this command:

The NDM plan specified by the PLAN parameter must exist and have been previously submitted to the NDM host application specified by the APPID parameter.
The NDM phase specified by the PHASE parameter must exist and be part of the NDM plan specified by the PLAN parameter.
The NDM phase specified by the PHASE parameter must be in a HELD state on the host system.
The device specified by the DEV parameter must be a SNUF device and must be program start request (PSR) capable.
This command runs only on a node which is currently functioning as a host interface node to the NDM host system. However, it is not restricted to releasing only those NDM phases whose destination is the node issuing the command. Any phase may be released for any node that shares the host interface node.

Restriction: To use this command, the user must be signed on as QPGMR or QSYSOPR, or have *ALLOBJ authority.

Parameters

Keyword	Description	Choices	Notes
PHASE	Phase	Communications name	Required, Positional 1
PLAN	Plan	Communications name	Required, Positional 2
APPID	Application identifier	Name	Required, Positional 3
RMTLOCNAME	Remote location	Communications name	Required, Positional 4
DEV	Device	Name	Required, Positional 5

Top

Phase (PHASE)

Specifies the name of the NetView Distribution Manager phase that is released. This phase must exist on the NDM host system as part of the plan specified by the PLAN parameter, and must be in a HELD state.

This is a required parameter.

Plan (PLAN)

Specifies the name of the NetView Distribution Manager plan that contains the phase that is released. This plan must exist on the NDM host.

This is a required parameter.

Application identifier (APPID)

Specifies the name of the NetView Distribution Manager application under which the phase name specified by the PHASE parameter was submitted. This is the same name by which NDM was made known to MVS when it was generated.

This is a required parameter.

Release Remote Phase (RMTLOCNAME)

Specifies the name of the remote location with which this device communicates. This should be the same name that is entered in the RMTLOCNAME parameter of the device specified by the DEV parameter.

This is a required parameter.

Device description (DEV)

Specifies the device name of the iSeries device to be used for the communications session started as a result of this command. The device must be a SNUF device and must be PSR capable.

This is a required parameter.

Examples

RLSRMTPHS   PHASE(MESSAGE)  PLAN(ALEXPLAN)  APPID(DSXNDM)
            RMTLOCNAME(A083187)  DEV(SNUFDEV)

This command initiates a session using device SNUFDEV with remote location name A083187 to connect with the System/370 NetView Distribution Manager host application DSXNDM. After the session connection is made, phase MESSAGE, as part of plan ALEXPLAN, attempts to release. If the release is successful, message CPC8889 (Phase MESSAGE released by NetView Distribution Manager) is sent. If the release is not successful, message CPF8880 (Phase MESSAGE not released by Netview Distribution Manager) is sent.