RLSRMTPHS (Release Remote Phase)

RLSRMTPHS Command syntax diagram

 

Purpose

The Release Remote Phase (RLSRMTPHS) command initiates a session between the iSeries 400 and a System/370* NetView* Distribution Manager (NDM) host system. After the NDM releases the phase, or there is an unsuccessful attempt to release the phase, the session is ended.

The following considerations apply when running this command:

• 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 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 device specified by the DEV parameter must be a Systems Network Architecture upline facility (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 sending the command. Any phase may be released for any node that shares the same host interface node sending this command.

Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR and QSYSOPR user profiles have private authorities to use the command.

 

Required Parameters

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.

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.

APPID

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

RMTLOCNAME

Specifies the remote location name of the system with which this object communicates.

Note:

The device with which the user's program is communicating is specified on the DEV parameter.

DEV

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

Example for RLSRMTPHS

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.

Error messages for RLSRMTPHS

*ESCAPE Messages

CPF8880

Phase &1 not released by NetView Distribution Manager.