LISTCONTROL structured field introducers

The structured field introducers produced for the LISTCONTROL subcommand with OUTPUT=FIELDS differ depending on whether the STATUS operand is specified.

The structured field introducers produced for the LISTCONTROL subcommand with OUTPUT=FIELDS are:

<Begin CONTROL Group>
  <Begin CNTL Group>
    <TZ   - Time Zone                :  4, bin(31)           >
    <MTP  - CDS type                 :  1, bin(8)            >
    <MDTJ - CDS Create Date          :  4, packed decimal    >
    <MTM  - CDS Create Time          :  4, packed decimal    >
    <UDTJ - CDS Last update date     :  4, packed decimal    >
    <UTM  - CDS Last update time     :  4, packed decimal    >
    <JRNU - Journal Percentage Used  :  2, bin(15)           >
    <JRNF - JOURNALFULL Parmlib Value:  2, bin(15)           >
    <JRNS - Journal status           :  1, bin(8)            >
    <BDTJ - Last CDS Backup Date     :  4, packed decimal    >
    <BTM  - Last CDS Backup Time     :  4, packed decimal    >
    <JBDT - Last journal backup date :  4, packed decimal    >
    <JBTM - Last journal backup time :  4, packed decimal    >
    <XDTJ - Expiration Date          :  4, packed decimal    >
    <XTM  - Last Inven Mgt Expir Time:  4, packed decimal    >
    <RDTJ - Last CDS Extract Date    :  4, packed decimal    >
    <RTM  - Last CDS Extract Time    :  4, packed decimal    >
    <DDTJ - Delete/Store Date        :  4, packed decimal    >
    <DTM  - Last Store update run tim:  4, packed decimal    >
    <SOSJ - Last XPROC Start Date    :  4, packed decimal    >
    <SOST - Last XPROC Start Time    :  4, packed decimal    >
    <VDTJ - Last Inven Mgt Proc Date :  4, packed decimal    >
    <VTM  - Last Inven Mgt VRS Time  :  4, packed decimal    >
    <LRK  - # Library Rack Numbers   :  4, bin(31)           >
    <FRK  - Free Rack Num in Library :  4, bin(31)           >
    <LBN  - Bin Numbers in LOCAL     :  4, bin(31)           >
    <FLB  - Free Bin Numbers in LOCAL:  4, bin(31)           >
    <DBN  - Bin Numbers in DISTANT   :  4, bin(31)           >
    <FDB  - Free Bins in DISTANT Loc :  4, bin(31)           >
    <RBN  - # Bin Numbers in REMOTE  :  4, bin(31)           >
    <FRB  - Free Bin Numbers in REMOT:  4, bin(31)           >
    <CACT - Control Active Functions :  1, bit(8)            >
    <CSDT - Catalog Synchronize date :  4, packed decimal    >
    <CSTM - Catalog Synchronize time :  4, packed decimal    >
    <FCSP - Catalog Synch in progress:  1, bin(8)            >
    <CSVE - Stacked volume enabled   :  1, bin(8)            >
    <X100 - EDGUX100 exit status     :  1, bin(8)            >
    <X200 - EDGUX200 exit status     :  1, bin(8)            >
    <X300 - EDGUX300 exit status     :  1, bin(8)            >
    <EBIN - Extended Bin Status      :  1, bin(8)            >
    <CDSU - CDS percentage used      :  2, bin(15)           >
    <CSHN - Client/Server host name  : 63, character         >
    <CSIP - Client/Server IP address : 15, character         >
    <UTC  - Common time status enable:  1, bin(8)            >
    <CDSQ - CDS id ENQ name enabled  :  1, bin(8)            >
    <RMID - RMM started procedure nam: 17, character         >
  <End CNTL Group>
  <Begin OPTION Group>
    <OPM  - Operating Mode           :  1, bin(8)            >
    <DRP  - Default Retention Period :  4, bin(31)           >
    <MRP  - Maximum Retention Period :  4, bin(31)           >
    <CRP  - CATRETPD Retention Period:  4, bin(31)           >
    <MDS  - CDS Data Set Name        : 44, character         >
    <JDS  - Journal Name             : 44, character         >
    <JRNF - JOURNALFULL Parmlib Value:  2, bin(15)           >
    <CATS - CATSYSID value           :  1, bin(8)            >
    <SOSP - Scratch Procedure Name   :  8, character         >
    <BKPP - Backup Procedure Name    :  8, character         >
    <IPL  - Data Check Required in IP:  1, bin(8)            >
    <DTE  - Installation Date Format :  1, bin(8)            >
    <RCF  - Installation RACF Support:  1, bin(8)            >
    <AUD  - SMF Audit Record Number  :  2, bin(15)           >
    <SSM  - SMF Security Record Numbe:  2, bin(15)           >
    <CDS  - Control Data Set ID      :  8, character         >
    <SLM  - MAXHOLD Value            :  2, bin(15)           >
    <LCT  - Default Lines per Page   :  2, bin(15)           >
    <SID  - SMF System ID            :  8, character         >
    <BLP  - BLP Option               :  1, bin(8)            >
    <NOT  - Notify                   :  1, bin(8)            >
    <UNC  - Uncatalog Option         :  1, bin(8)            >
    <VRJ  - VRS Job Name             :  1, bin(8)            >
    <MSGF - Case of Message Text     :  1, bin(8)            >
    <MOP  - Master Overwrite         :  1, bin(8)            >
    <ACCT - Accounting Source        :  1, bin(8)            >
    <VCHG - VRSCHANGE Value          :  1, bin(8)            >
    <VRSL - VRSEL Value              :  1, bin(8)            >
    <PSFX - Parmlib Member Suffix    :  2, character         >
    <PSF2 - Parmlib Member Suffix 2  :  2, character         >
    <VACT - VRSMIN action            :  1, bin(8)            >
    <VMIN - VRSMIN Count Value       :  4, bin(31)           >
    <JRNT - Journal transaction      :  1, bin(8)            >
    <VDRA - VRS Drop Action          :  1, bin(8)            >
    <VDRC - VRS Drop Count           :  4, bin(31)           >
    <VDRP - VRS Drop Percentage      :  2, bin(15)           >
    <VREA - VRS Retain Action        :  1, bin(8)            >
    <VREC - VRS Retain Count         :  4, bin(31)           >
    <VREP - VRS Retain Percentage    :  2, bin(15)           >
    <XDRA - EXPDT Drop Action        :  1, bin(8)            >
    <XDRC - EXPDT Drop Count         :  4, bin(31)           >
    <XDRP - EXPDT Drop Percentage    :  2, bin(15)           >
    <DSPD - Disposition DD name      :  8, character         >
    <DSPM - Disposition message prefi:  8, character         >
    <RTBY - Retain by                :  1, bin(8)            >
    <MVBY - Move by                  :  1, bin(8)            >
    <GDGC - GDG cycleby              :  1, bin(8)            >
    <GDGD - GDG duplicate            :  1, bin(8)            >
    <PDA  - PDA state                :  1, bin(8)            >
    <PDAC - PDA block count          :  1, bin(8)            >
    <PDAS - PDA block size           :  1, bin(8)            >
    <PDAL - PDA log state            :  1, bin(8)            >
    <TVXP - Extradays retention      :  1, bin(8)            >
    <TVXD - Extradays for TVEXTPURGE :  4, bin(31)           >
    <SMP  - System managed tape purge:  1, bin(8)            >
    <SMU  - System managed tape updat:  1, bit(8)            >
    <ACS  - SMS ACS support          :  1, bin(8)            >
    <PACS - Pre-ACS support          :  1, bin(8)            >
    <RUB  - Reuse Bin at             :  1, bin(8)            >
    <CMDD - Command Auth DSN         :  1, bin(8)            >
    <CMDO - Command Auth Owner       :  1, bin(8)            >
    <MEDN - Media Name               :  8, character         >
    <LCTK - Local Task               :  4, bin(31)           >
    <SSTY - Subsystem type           :  1, bin(8)            >
    <SRHN - Server host name         : 63, character         >
    <SRIP - Server IP Address        : 15, character         >
    <SRPN - Server port number       :  4, bin(31)           >
    <SRTK - Server task              :  4, bin(31)           >
    <RM   - Retention Method         :  1, bin(8)            >
    <LRED - LASTREF extra days       :  4, bin(31)           >
    <EXRB - EXPDT RetainBy           :  1, bin(8)            >
    <MCAT - Management class attribut:  1, bin(8)            >
  <End OPTION Group>
  <Begin SECCLS Group>
    <SEC  - Security Class Number    :  1, bin(8)            >
    <NME  - Security Class Name      :  8, character         >
    <SCST - Security Class Status    :  1, bit(8)            >
    <CLS  - Security Class Descriptio: 32, character         >
  <End SECCLS Group>
  <Begin VLPOOL Group>
    <PID  - Pool Prefix              :  6, character         >
    <PSN  - Pool Definition System ID:  8, character         >
    <PRF  - Pool Def RACF Option     :  1, bin(8)            >
    <PTP  - Pool Def Pool Type       :  1, bin(8)            >
    <XDC  - Expiration Date Check    :  1, bin(8)            >
    <ACT  - Action on Release        :  1, bit(8)            >
    <SCRM - Scratch mode             :  1, bin(8)            >
    <PLN  - Pool Name                :  8, character         >
    <MEDN - Media Name               :  8, character         >
    <PDS  - Pool Description         : 40, character         >
    <MOP  - Master Overwrite         :  1, bin(8)            >
  <End VLPOOL Group>
  <Begin MNTMSG Group>
    <MID  - Mount Message ID         : 12, character         >
    <SMI  - Offset to Message ID     :  2, bin(15)           >
    <OVL  - Offset to Volume Serial  :  2, bin(15)           >
    <OPL  - Offset Rack Num or Pool I:  2, bin(15)           >
  <End MNTMSG Group>
  <Begin REJECT Group>
    <GRK  - Generic Rack Number      :  6, character         >
    <TAC  - Reject Type              :  1, bin(8)            >
  <End REJECT Group>
  <Begin LOCDEF Group>
    <LDDF - Location Definition Exist:  1, bin(8)            >
    <LDLC - Location Name            :  8, character         >
    <LDMT - Location Management Type :  1, bin(8)            >
    <LDLT - Location Type            :  1, bin(8)            >
    <LDPR - Location Priority        :  4, bin(31)           >
    <LDAM - Location Automove        :  1, bin(8)            >
    <LDMN - Location Media Name      :  8, character         >
  <End LOCDEF Group>
  <Begin MEDINF Group>
    <MDNF - Media Information Name   :  8, character         >
    <MEDT - Media Type               :  1, bin(8)            >
    <MDTX - External Media Type      :  8, character         >
    <MEDR - Media Recording Format   :  1, bin(8)            >
    <MDRX - External Recording Techn.:  8, character         >
    <VCAP - Volume capacity          :  4, bin(31)           >
    <MDRP - MEDINF Replace Policy Per:  4, bin(31)           >
    <MDRT - MEDINF Replace Policy Tem:  4, bin(31)           >
    <MDRW - MEDINF Replace Policy Wri:  4, bin(31)           >
    <MDRA - MEDINF Replace Policy Age:  4, bin(31)           >
  <End MEDINF Group>
  <Begin PRTITION Group>
    <PTVL - Volume Serial Number     :  6, character         >
    <PTVS - Volume Range Start       :  6, character         >
    <PTVE - Volume Range End         :  6, character         >
    <PTTP - Type of Partition Entry  :  1, bin(8)            >
    <PTSA - SMT Action for Partition :  1, bin(8)            >
    <PTNA - NOSMT Action for Partitio:  1, bin(8)            >
    <PTNL - Location Name            :  8, character         >
  <End PRTITION Group>
  <Begin OPENRULE Group>
    <ORVL - Volume Serial Number     :  6, character         >
    <ORVS - Volume Range Start       :  6, character         >
    <ORVE - Volume Range End         :  6, character         >
    <ORTP - Type of Openrule Entry   :  1, bin(8)            >
    <ORIA - Input Action             :  1, bin(8)            >
    <ORII - Input Ignore Condition   :  1, bit(8)            >
    <ORIR - Input Reject Condition   :  1, bit(8)            >
    <OROA - Output Action            :  1, bin(8)            >
    <OROI - Output Ignore Condition  :  1, bit(8)            >
    <OROR - Output Reject Condition  :  1, bit(8)            >
  <End OPENRULE Group>
  <Begin ACTIONS Group>
    <ACT  - Action on Release        :  1, bit(8)            >
    <AST  - Action Status            :  1, bit(8)            >
  <End ACTIONS Group>
  <Begin MOVES Group>
    <MFR  - Source Location Name     :  8, character         >
    <MST  - Move Status              :  1, bin(8)            >
    <MTO  - Target Location Name     :  8, character         >
    <MTY  - Move Type                :  1, bin(8)            >
  <End MOVES Group>
<End CONTROL Group>

The structured field introducers produced for the LISTCONTROL STATUS subcommand with OUTPUT=FIELDS are:

<Begin CONTROL Group>
  <Begin STATUS Group>
    <STRM - DFSMSrmm status          :  1, bin(8)            >
    <JRNS - Journal status           :  1, bin(8)            >
    <STSL - Server listener status   :  1, bin(8)            >
    <STLO - Local tasks              :  3, bin(15)           >
    <STLA - Local active tasks       :  3, bin(15)           >
    <STLH - Local held tasks         :  3, bin(15)           >
    <STSO - Server tasks             :  3, bin(15)           >
    <STSA - Server active tasks      :  3, bin(15)           >
    <STSH - Server held tasks        :  3, bin(15)           >
    <STQR - Queued requests          :  4, bin(32)           >
    <STQN - Nowait requests          :  4, bin(32)           >
    <STQC - Catalog requests         :  4, bin(32)           >
    <STLR - Last RESERVE             :  4, packed decimal    >
    <STNH - New requests held        :  1, bin(8)            >
    <STRH - CDS reserved             :  1, bin(8)            >
    <STDS - Debug setting            :  1, bit(8)            >
    <STPL - Trace levels             :  1, bit(8)            >
  <End STATUS Group>
  <Begin TASKS Group>
    <STRF - Task req. function       :  5, character         > 
    <STRT - Task req. system         :  8, character         >   
    <STTR - Task req. type           :  3, character         >  
    <STTQ - Task requestor           :  8, character         >
    <STST - Task start time          :  4, packed decimal    >
    <STTT - Task token               :  4, bin(32)           >
    <STTS - Task status              :  1, bin(8)            >       
    <STIV - IP verb                  :  1, bin(8)            >  
    <STIS - IP verb state            :  1, bin(8)            >
    <STIT - IP verb time             :  4, packed decimal    >   
  <End TASKS Group>
<End CONTROL Group>

When there is no information for a subgroup, such as MOVES, for the LISTCONTROL subcommand, the DFSMSrmm API returns all of the structured field introducers in the subgroup with no data. For example, when there are no outstanding volume actions, the DFSMSrmm API returns the MOVES subgroup (MFR, MST, MTO and MTY) with no data.

When DFSMSrmm cannot return all the output data for the LISTCONTROL subcommands in your output buffer, you must specify OPERATION=CONTINUE after processing your output buffer to obtain the rest of the LISTCONTROL output data.

Related reading: See Using the CONTINUE operation in the EDGXCI macro for additional information.