Close(PLU) Request

The Close(PLU) Request message flows from the node to the application and from the application to the node. It is used with a PLU connection.

struct Close (PLU) Request {
    PTRBFHDR  nxtqptr;
    PTRBFELT  hdreptr;
    CHAR      numelts;
    CHAR      msgtype;
    CHAR      srcl;
    CHAR      srcp;
    INTEGER   srci;
    CHAR      destl;
    CHAR      destp;
    INTEGER   desti;
    CHAR      clhdr.closqual;
    CHAR      clhdr.clstype;
    CHAR      clhdr.clsctl;
    CHAR      clhdr.clspad1;
    INTEGER   clhdr.clspad2;
    INTEGER   clhdr.clserr1;
}; 
 

LUA only (see Remarks):
Element

struct Close (PLU) Request {
    PTRBFELT hdreptr->elteptr;
    INTEGER hdreptr->startd;
    INTEGER hdreptr->endd;
    CHAR hdreptr->trpad;
    CHAR[268] hdreptr->dataru;
}; 
 

Members

nxtqptr

Pointer to next buffer header.

hdreptr

Pointer to buffer element (NIL if not using LUA).

numelts

Number of buffer elements (0x00 if not using LUA).

msgtype

Message type CLOSEMSG (0x02).

srcl

Source locality.

srcp

Source partner.

srci

Source index.

destl

Destination locality.

destp

Destination partner.

desti

Destination index.

clhdr.closqual

Close qualifier REQU (0x01).

clhdr.clstype

Close subtype LUSEC (0x02).

clhdr.clsctl

Close control

CLNORMAL (0x01) - normal
CLBIND (0x02) - bind forthcoming
CLCFAERR (0x03) - CFA error
CLPUINAC (0x04) - PU inactive
CLLUINAC (0x05) - LU inactive
CLLNKERR (0x06) - link error
CLBFSHRT (0x07) - node buffer shortage
CLRCVCHK (0x08) - DFC receive check
CLSLUTRM (0x09) - SLU termination

clhdr.clspad1

Reserved.

clhdr.clspad2

Reserved.

clhdr.clserr1

Error code (only valid for close control = link error).

LUA only (see Remarks):
Element

hdreptr–>elteptr

Pointer to buffer element (NIL).

hdreptr–>startd

Start of data in this buffer element (13).

hdreptr–>endd

End of data in this buffer element.

hdreptr–>trpad

Reserved.

hdreptr–>dataru

The UNBIND RU received from the host, with its TH and RH.

Remarks

• If the application is using the LUA variant of the FMI (see FMI Concepts), and the Close(PLU) Request was generated by receipt of an UNBIND from the host, then the element is included and startd points to the TH of the UNBIND message.
• In all other cases (for example, if the Close(PLU) Request was generated by the local node as a result of a link outage), the message consists of a buffer header only; there is no buffer element.
• The close control field is only valid on messages from the local node to the application.
• If the close control field specifies link error, then the error code field gives the link outage code.