Edit

Share via

Close(PLU) Request

  • Article

The Close(PLU) Request message flows from the node to the application and from the application to the node. It is used with a primary logical unit (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;  
};   
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 request/response unit (RU) received from the host, with its transmission header (TH) and response header (RH).

Remarks

  • If the application is using the LUA variant of the function management interface (FMI), and the Close(PLU) Request was generated by receipt of an UNBIND from the host, the element is included, and startd points to the TH of the UNBIND message. (For more information about FMI, see FMI Concepts.)

  • 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, the error code field gives the link outage code.