About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
MUCBK
Control Block Contents
MUCBK DSECT
MUC_COM_DATA DSECT
MUC_COM_CONFIG DSECT
MUC_COM_TERM DSECT
Cross Reference (Contains links to field and bit definitions)
MUCBK Prolog
NAME : HCPMUCBK
DESCRIPTION: Monitor User Control Block
DSECT : MUCBK
FUNCTION : Represents a user that has been connected to
*MONITOR System Service.
Storage type is sys perm.
LOCATED BY : Data structure Field location
MUC_NEXT field in MUCBK
MUC_PREV field in MUCBK
MNDI_CONN_HEAD field in MNDBK
MNDI_CONN_TAIL field in MNDBK
MNDI_SEV_PURGEF_H field in MNDBK
MNDI_SEV_PURGEF_T field in MNDBK
MNDE_MAIL_H field in MNDBK
MNDS_MAIL_H field in MNDBK
MNDE_PC_HEAD field in MNDBK
MNDS_PC_HEAD field in MNDBK
CREATED BY : HCPMNICN - *MONITOR IUCV CONNECT processing
DELETED BY : HCPMOIER - Process IUCV REPLY to Event Data Message
HCPMOISR - Process IUCV REPLY to Sample Data Message
HCPMXBCR - Process IUCV REPLY to Config Message
HCPMXESU - Sever Monitor User's IUCV Path to *MONITOR
HCPMOIRT - Process IUCV REPLY to Termination messages
REFERENCES : none
SERIALIZED : N/A
NOTES : The forward and backward
pointers must occupy the first two words of this
control block.
MUCBK Control Block Content
MUCBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure MUCBK Monitor User Control Block 0000 0 Address 4 MUC_NEXT Forward pointer to the next block on the chain - MUST BE FIRST IN BLOCK 0004 4 Address 4 MUC_PREV Backward pointer to the prev block on the chain - MUST BE SECOND IN BLOCK 0008 8 Character 8 MUC_USERID Userid 0010 16 Address 4 MUC_VMDBKAD Address of user's VMDBK User Session Data These characteristics are established when the user connects to **MONITOR. 0014 20 Bitstring 26 MUC_SESSION (0) Static Session Data User Static Session Data. This does not change while the user is connected. 0014 20 Bitstring 1 MUC_MON_TYPE Type of monitoring requested by user. At least one of these flags will be on. Serialized by the MND_CMD_LOCK 1... .... MUC_S_CONN X'80' Connected for sample data. This user is "eligible" for data messages if he is NOT on the sample pending- config list (MNDS_PC_LIST). .1.. .... MUC_E_CONN X'40' Connected for EVENT data ... this user is "eligible" for data messages if he is NOT on the event pending- config list (MNDE_PC_LIST). 0015 21 Bitstring 1 * Reserved for IBM use 0016 22 Bitstring 8 MUC_IUCV (0) Serialized by the MND_CMD_LOCK 0016 22 Address 2 MUC_PATHID IUCV-assigned pathid for the path between *MONITOR and this user's virtual machine 0018 24 Signed 1 MUC_MSGLIM (0) IUCV message limit information 0018 24 Bitstring 2 MUC_I_MSGLIM IUCV message limit for this path established when *MONITOR does the IUCV ACCEPT for this path 001A 26 Bitstring 2 * Reserved for IBM use User Dynamic Session Data. This can change while the user is connected. 001C 28 Bitstring 16 MUC_USER_STAT (0) Dynamic session data 001C 28 Bitstring 1 MUC_SAMPLE_STA (0) Sample Status 001C 28 Bitstring 1 MUC_SAMPLE_FLG Sample Status Flags 1... .... MUC_S_HC X'80' Holding sample config records. Serialized by MND_CMD_LOCK 001D 29 Bitstring 1 MUC_EVENT_STAT (0) Event Status 001D 29 Bitstring 1 MUC_EVENT_FLGS Event flags 1... .... MUC_E_HC X'80' Holding event config records. Serialized by MND_CMD_LOCK 001E 30 Bitstring 1 MUC_QUIS (0) 001E 30 Bitstring 1 MUC_QUIS_FLAGS Quiesce flags 1... .... MUC_QUIESCE X'80' User's path is quiesced. Serialized by MND_CMD_LOCK and the MNDE_MAIL_LOCK. 001F 31 Bitstring 1 * Reserved for IBM use 0020 32 Bitstring 8 MUC_SEVER (0) 0020 32 Bitstring 1 MUC_SEVER_FLGS Sever flags 0021 33 Bitstring 3 * Reserved for IBM use. 0024 36 Signed 4 MUC_PURGEF_CT Count of "purge-failed" messages - i.e. the number of messages that *MONITOR attempted to purge but failed to do so. 0028 40 Signed 4 MUC_MSG_CT Count of outstanding messages for this user (config, data and termination) Managing Event messages 002C 44 Bitstring 60 MUC_EVENT (0) 002C 44 Bitstring 30 MUC_EVENT_DATA (0) Event data mail list 002C 44 Address 4 MUC_EMAIL_NEXT Pointer to next MUCBK on event mail list (MNDE_MAIL). This field will contain hex FF's if this user is not on the mail list. Serialized by MNDE_MAIL_LOCK plus the MND_CMD_LOCK for updating. Either lock is sufficient for read only access. 0030 48 Address 4 MUC_EMAIL_PREV Pointer to previous MUCBK on the event mail list (MNDE_MAIL). This field will contain hex FF's if this user is not on the mail list. Serialized by MNDE_MAIL_LOCK plus the MND_CMD_LOCK for updating. Either lock is sufficient for read only access. 0034 52 Bitstring 11 MUC_ED_SENT (0) Chain of MMLBKs, each representing a message sent to the user for event data and for which *MONITOR is now awaiting a reply. Also mapped by MUC_COM_DATA. 0034 52 Address 4 MUC_ED_SENT_H Pointer to the head of this user's list of MMLBKs for sent EVENT data messages. When the list is empty, this field points to itself 0038 56 Address 4 MUC_ED_SENT_T Pointer to the tail of this user's list of MMLBKs for sent EVENT data messages. When the list is empty this field contains the address of the head, MUC_ED_SEND_H. 003C 60 Address 2 MUC_ED_SENT_CT count of EVENT data messages outstanding for this user 003E 62 Bitstring 1 * Reserved for IBM use 003F 63 Bitstring 1 * Reserved for IBM use 0040 64 Bitstring 10 MUC_ED_PEND (0) This is a circular list of MMLBKs for event data messages that are pending for this user. Serialized by MNDI_EV_SENT.MND_LOCK 0040 64 Address 4 MUC_ED_PEND_H Pointer to the head of this user's list of MMLBKs for pending event data messages. When the list is empty this field points to itself. 0044 68 Address 4 MUC_ED_PEND_T Pointer to the tail of this user's list of MMLBKs for pending event data messages. When the list is empty this field contains the address of the head, MUC_ED_PEND_H. 0048 72 Address 2 MUC_ED_PEND_CT Count of pending EVENT data messages for this user. 004A 74 Bitstring 2 * Reserved for IBM use EVENT config messages 004C 76 Bitstring 16 MUC_EVENT_CONF (0) These fields are serialized by the MND_CMD_LOCK. 004C 76 Address 4 MUC_EPC_NEXT Pointer to next MUCBK on event Pending-Config list (MNDE_PC_LIST). This field will contain hex FF's if this user is not on the list. 0050 80 Address 4 MUC_EPC_PREV Pointer to previous MUCBK on event Pending-Config list (MNDE_PC_LIST). This field will contain hex FF's if this user is not on the list. 0054 84 Bitstring 8 MUC_EC_SENT (0) A chain of MMLBKs, each representing a message sent to the user for event config data and for which *MONITOR is now awaiting a reply. Also mapped by MUC_COM_CONFIG. 0054 84 Address 4 MUC_EC_SENT_H Pointer to head of this user's list of EVENT config MMLs. When the list is empty, this field points to itself. Note: if this list is not empty, that does NOT necessarily mean that this user is holding the config area. However, only 1 MML at a time can be "active" - any others on the list represent messages that monitor tried to purge. (See MMLBK). 0058 88 Address 4 MUC_EC_SENT_T Pointer to tail of this user's list of EVENT config MMLs. When the list is empty, this field contains the address of the head, MUC_EC_SENT_H. EVENT termination messages 005C 92 Bitstring 12 MUC_EVENT_TERM (0) These fields are serialized by the MND_CMD_LOCK. 005C 92 Bitstring 8 MUC_ET_SENT (0) 005C 92 Address 4 MUC_ET_SENT_H Pointer to head of this user's list of EVENT termination MMLs. (Note: only 1 MML at a time can be "active" - any others on the list represent messages that monitor tried to purge (See MMLBK). When the list is empty, this field points to itself. 0060 96 Address 4 MUC_ET_SENT_T Pointer to tail of this user's list of EVENT termination messages. When the list is empty, this field contains the address of the head, MUC_ET_SENT_H. 0064 100 Bitstring 1 MUC_ET_PEND Termination flag 1... .... MUC_ET_PEND_FL X'80' Pending flag for termination message. ON = user needs an event termination message. A termination message will be sent when the user resumes his path. 0065 101 Bitstring 3 * Reserved for IBM use Managing SAMPLE messages 0068 104 Bitstring 48 MUC_SAMPLE (0) Sample data e-mail list 0068 104 Bitstring 1 MUC_SAMPLE_DAT (0) Sample data messages 0068 104 Address 4 MUC_SMAIL_NEXT Pointer to next MUCBK on sample mail list (MNDS_MAIL). This field will contain hex FF's if this user is not on the mail list. Serialized by MND_CMD_LOCK. 006C 108 Address 4 MUC_SMAIL_PREV Pointer to previous MUCBK on sample mail list (MNDS_MAIL). This field will contain hex FF's if this user is not on the mail list. Serialized by MND_CMD_LOCK. 0070 112 Bitstring 11 MUC_SD_SENT (0) Chain of MMLBKs, each representing a message sent to the user for sample data and for which *MONITOR is now awaiting a reply. Also mapped by MUC_COM_DATA. 0070 112 Address 4 MUC_SD_SENT_H Pointer to the head of this user's list of MMLs for sent SAMPLE data messages. When the list is empty, this field points to itself. 0074 116 Address 4 MUC_SD_SENT_T Pointer to the tail of this user's list of MMLs for sent SAMPLE data messages. When the list is empty, this field points to the head, MUC_SD_SENT_H. 0078 120 Address 2 MUC_SD_SENT_CT Count of SAMPLE data messages (MMLs) outstanding for this path 007A 122 Bitstring 1 MUC_SD_LOST Sample flags 1... .... MUC_SD_LOSG_BI X'80' The user has miss one or more messages while his path was quiesced. 007B 123 Bitstring 1 * Reserved for IBM use SAMPLE config messages 007C 124 Bitstring 16 MUC_SAMPLE_CON (0) Sample configuration data e-mail list Serialized by MND_CMD_LOCK. 007C 124 Address 4 MUC_SPC_NEXT Pointer to next MUCBK on sample pending-config list (MNDS_PC_LIST). This field will contain hex FF's if this user is not on the list (ie. if this user is not waiting foe sample config records.) 0080 128 Address 4 MUC_SPC_PREV Pointer to previous MUCBK on the sample pending-config list (MNDS_PC_LIST). This field will contain hex FFs if this user is not on the list (ie. if user is not waiting for sample config records. 0084 132 Bitstring 8 MUC_SC_SENT (0) Chain of MMLBKs, each representing a message sent to the user for sample config data and for which *MONITOR is now awaiting a reply. Also mapped by MUC_COM_CONFIG. 0084 132 Address 4 MUC_SC_SENT_H Pointer to head of this user's list of SAMPLE config MMLs. (Note: only 1 MML at a time can be "active" - any others on the list represent messages that monitor tried to purge. See MMLBK). When the list is empty this field points to itself. 0088 136 Address 4 MUC_SC_SENT_T Pointer to tail of this user's list of SAMPLE config MMLs. When the list is empty, this field points to the head, MUC_SC_SENT_H. 008C 140 Bitstring 12 MUC_SAMPLE_TER (0) Outstanding sample termination data 008C 140 Bitstring 8 MUC_ST_SENT (0) Circular list of MMLBKs for sent sample termination messages. 008C 140 Address 4 MUC_ST_SENT_H Pointer to head of this user's list of SAMPLE termination MMLs. (Note: only 1 MML at a time can be "active" - any others on the list represent messages that monitor tried to purge. See MMLBK). When the list is empty this field points to itself. 0090 144 Address 4 MUC_ST_SENT_T Pointer to tail of this user's list of SAMPLE termination messages. When the list is empty, this field points to the head, MUC_ST_SENT_H. 0094 148 Bitstring 1 MUC_ST_PEND Termindation flags 1... .... MUC_ST_PEND_FL X'80' Pending flag for termination message. A termination message will be sent when when user resumes his path. 0095 149 Bitstring 3 * Reserved for IBM use 00000098 MUC$END * 00000013 MUCSIZE (MUC$END-MUCBK+7)/8 MUCBK size in doublewords MUC_COM_DATA - Map for sample and event data sent fields. Common mapping for MUC_ED_SENT or MUC_SD_SENT.
MUC_COM_DATA DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure MUC_COM_DATA Monitor User Control Block 0000 0 Address 4 MUC_COMD_SENTH Pointer to the head of this user's list of MMLs for sent data messages 0004 4 Address 4 MUC_COMD_SENTT Pointer to the tail of this user's list of MMLs for sent data messages 0008 8 Address 2 MUC_COMD_SENTC Count of outstanding data messages for this user. 000A 10 Bitstring 1 MUC_COMD_LOST Messages flags MUC_COM_CONFIG - Map for sample and event config sent fields. Common mapping for MUC_EC_SENT or MUC_SC_SENT.
MUC_COM_CONFIG DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure MUC_COM_CONFIG Monitor User Control Block 0000 0 Address 4 MUC_COMC_SENTH Pointer to the head of this user's list of MMLs for sent config messages 0004 4 Address 4 MUC_COMC_SENTT Pointer to the tail of this user's list of MMLs for sent config messages MUC_COM_TERM - Map for sample and event data TERMINATION fields. Common mapping for MUC_EVENT_TERM and MUC_SAMPLE_TERM
MUC_COM_TERM DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure MUC_COM_TERM Monitor User Control Block 0000 0 Address 4 MUC_COMT_SENTH Pointer to the head of this user's list of MMLs for termination messages 0004 4 Address 4 MUC_COMT_SENTT Pointer to the tail of this user's list of MMLs for termination messages 0008 8 Bitstring 1 MUC_COMT Termination flags 1... .... MUC_COMT_FLAG X'80' Termination message pending 0009 9 Bitstring 3 * Reserved for IBM use
MUCBK Storage Layout
*** MUCBK - Monitor User Control Block * * +---------------------------+---------------------------+ * 0 | MUC_NEXT | MUC_PREV | * +---------------------------+---------------------------+ * 8 | MUC_USERID | * +---------------------------+------+------+-------------+ * 10 | MUC_VMDBKAD |(014) |//////| MUC_PATHID | * +-------------+-------------+------+------+------+------+ * 18 |MUC_I_MSGLIM |/////////////|(01C) |(01D) |(01E) |//////| * +------+------+-------------+------+------+------+------+ * 20 |(020) |////////////////////| MUC_PURGEF_CT | * +------+--------------------+---------------------------+ * 28 | MUC_MSG_CT | MUC_EMAIL_NEXT | * +---------------------------+---------------------------+ * 30 | MUC_EMAIL_PREV | MUC_ED_SENT_H | * +---------------------------+-------------+------+------+ * 38 | MUC_ED_SENT_T |:_ED_SENT_CT |//////|//////| * +---------------------------+-------------+------+------+ * 40 | MUC_ED_PEND_H | MUC_ED_PEND_T | * +-------------+-------------+---------------------------+ * 48 |:_ED_PEND_CT |/////////////| MUC_EPC_NEXT | * +-------------+-------------+---------------------------+ * 50 | MUC_EPC_PREV | MUC_EC_SENT_H | * +---------------------------+---------------------------+ * 58 | MUC_EC_SENT_T | MUC_ET_SENT_H | * +---------------------------+------+--------------------+ * 60 | MUC_ET_SENT_T |(064) |////////////////////| * +---------------------------+------+--------------------+ * 68 | MUC_SMAIL_NEXT | MUC_SMAIL_PREV | * +---------------------------+---------------------------+ * 70 | MUC_SD_SENT_H | MUC_SD_SENT_T | * +-------------+------+------+---------------------------+ * 78 |:_SD_SENT_CT |(07A) |//////| MUC_SPC_NEXT | * +-------------+------+------+---------------------------+ * 80 | MUC_SPC_PREV | MUC_SC_SENT_H | * +---------------------------+---------------------------+ * 88 | MUC_SC_SENT_T | MUC_ST_SENT_H | * +---------------------------+------+--------------------+ * 90 | MUC_ST_SENT_T |(094) |////////////////////| * +---------------------------+------+--------------------+ * 98 * *** MUCBK - Monitor User Control Block *** MUC_COM_DATA - Monitor User Control Block * * +---------------------------+---------------------------+ * 0 | MUC_COMD_SENTH | MUC_COMD_SENTT | * +-------------+------+------+---------------------------+ * 8 |:_COMD_SENTC |(00A) | B * +-------------+------+ * *** MUC_COM_DATA - Monitor User Control Block *** MUC_COM_CONFIG - Monitor User Control Block * * +---------------------------+---------------------------+ * 0 | MUC_COMC_SENTH | MUC_COMC_SENTT | * +---------------------------+---------------------------+ * 8 * *** MUC_COM_CONFIG - Monitor User Control Block *** MUC_COM_TERM - Monitor User Control Block * * +---------------------------+---------------------------+ * 0 | MUC_COMT_SENTH | MUC_COMT_SENTT | * +------+--------------------+---------------------------+ * 8 |:_COMT|////////////////////| C * +------+--------------------+ * *** MUC_COM_TERM - Monitor User Control Block
MUCBK Cross Reference
Symbol Dspl Value -------------- ---- ----- MUC$END 0095 00000098 MUC_COMC_SENTH 0000 MUC_COMC_SENTT 0004 MUC_COMD_LOST 000A MUC_COMD_SENTC 0008 MUC_COMD_SENTH 0000 MUC_COMD_SENTT 0004 MUC_COMT 0008 MUC_COMT_FLAG 0008 80 MUC_COMT_SENTH 0000 MUC_COMT_SENTT 0004 MUC_E_CONN 0014 40 MUC_E_HC 001D 80 MUC_EC_SENT 0054 MUC_EC_SENT_H 0054 MUC_EC_SENT_T 0058 MUC_ED_PEND 0040 MUC_ED_PEND_CT 0048 MUC_ED_PEND_H 0040 MUC_ED_PEND_T 0044 MUC_ED_SENT 0034 MUC_ED_SENT_CT 003C MUC_ED_SENT_H 0034 MUC_ED_SENT_T 0038 MUC_EMAIL_NEXT 002C MUC_EMAIL_PREV 0030 MUC_EPC_NEXT 004C MUC_EPC_PREV 0050 MUC_ET_PEND 0064 MUC_ET_PEND_FL 0064 80 MUC_ET_SENT 005C MUC_ET_SENT_H 005C MUC_ET_SENT_T 0060 MUC_EVENT 002C MUC_EVENT_CONF 004C MUC_EVENT_DATA 002C MUC_EVENT_FLGS 001D MUC_EVENT_STAT 001D MUC_EVENT_TERM 005C MUC_I_MSGLIM 0018 MUC_IUCV 0016 MUC_MON_TYPE 0014 MUC_MSG_CT 0028 MUC_MSGLIM 0018 MUC_NEXT 0000 MUC_PATHID 0016 MUC_PREV 0004 MUC_PURGEF_CT 0024 MUC_QUIESCE 001E 80 MUC_QUIS 001E MUC_QUIS_FLAGS 001E MUC_S_CONN 0014 80 MUC_S_HC 001C 80 MUC_SAMPLE 0068 MUC_SAMPLE_CON 007C MUC_SAMPLE_DAT 0068 MUC_SAMPLE_FLG 001C MUC_SAMPLE_STA 001C MUC_SAMPLE_TER 008C MUC_SC_SENT 0084 MUC_SC_SENT_H 0084 MUC_SC_SENT_T 0088 MUC_SD_LOSG_BI 007A 80 MUC_SD_LOST 007A MUC_SD_SENT 0070 MUC_SD_SENT_CT 0078 MUC_SD_SENT_H 0070 MUC_SD_SENT_T 0074 MUC_SESSION 0014 MUC_SEVER 0020 MUC_SEVER_FLGS 0020 MUC_SMAIL_NEXT 0068 MUC_SMAIL_PREV 006C MUC_SPC_NEXT 007C MUC_SPC_PREV 0080 MUC_ST_PEND 0094 MUC_ST_PEND_FL 0094 80 MUC_ST_SENT 008C MUC_ST_SENT_H 008C MUC_ST_SENT_T 0090 MUC_USER_STAT 001C MUC_USERID 0008 MUC_VMDBKAD 0010 MUCSIZE 0095 00000013
This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:06:15 EDT.
Copyright IBM Corporation, 1990, 2005
