IDMSLOOK

The IDMSLOOK load module print utility reports on the contents of selected load modules. Using IDMSLOOK, you can report on:
idmscu19
The IDMSLOOK load module print utility reports on the contents of selected load modules. Using IDMSLOOK, you can report on:
  • The contents of a database name table module
  • Area, record, and set information in a subschema load module
  • Area, record, set, file, and physical characteristics for a subschema bound to a specific database
  • File, area, journal, and buffer information in a DMCL load module together with its associated database name table information
  • The names of the RCM modules characteristics of the tables that are referenced by the access module
  • A hexadecimal dump of a specified load module in a format suitable for display at a 3270-type terminal
  • The date/time stamps of the component modules in a specified load module
  • The external value of internal date/time stamps
  • The contents of the product intent module RHDCPINT
The following topics are discussed on this page:
2
2
Syntax
┌────────────────────────────────────────────────────────────────────────┐ ►►─▼┬──────────────────────────────────────────────────────────────────────┬┴─►◄ └── look-command ──────────────────────────────────────────────────────┘
Expansion of look-command
►►─┬─ AM= access-module-name ─────────────────────────────────┬─────────┬────┬─►◄ │ └ fib-opt ┘ │ │ │ ├─ AM PROGRAM= access-module-name ────────────────────────────────────────┤ │ │ ├─ BIND SQL SEGMENT=segment-name,DBNAME=database-name ─────┬─────────┬────┤ │ └ fib-opt ┘ │ │ │ ├─ BIND SUBSCHEMA= subschema-name ┬──────────────────────┬───┬─────────┬──┤ │ └ DBNAME=database-name ┘ └ fib-opt ┘ │ │ │ ├─ DATES= load-module-name ───────────────────────────────────────────────┤ │ │ ├─ DATETIME ──────────────────────────────────────────────────────────────┤ │ │ ├─ DATETIME STAMP= hex-internal-datetime-stamp ───────────────────────────┤ │ │ ├─ DBTABLE ───────────────────────────────────────────────────────────────┤ │ │ ├─ DBTABLE= dbtable-name ─────────────────────────────────────────────────┤ │ │ ├─ DMCL ─┬───────┬──┬────────────────┬────────────────────┬─────────┬─────┤ │ └─ ALL ─┘ ├─ SORTED ───────┤ └─ RADIX ─┘ │ │ └─ SORTED PAGES ─┘ │ │ │ ├─ EXTERNAL DATETIME=external-datetime-value ─────────────────────────────┤ │ │ ├─ FIND=hex-string ───────────────────────────────────────────────────────┤ │ │ ├─ HELP ──────────────────────────────────────────────────────────────────┤ │ │ ├─ LOA
D=OPSYS ────────────────────────
────────────────────────────────────┤ │ │ ├─ OPTION FLAGS ──────────────────────────────────────────────────────────┤ │ │ ├─ PROGRAM= load-module-name ─────────────────────────────────────────────┤ │ │ ├─ PROGRAM POOL ──────────────────────────────────────────────────────────┤ │ │ ├─ RCM PROGRAM= RCM-module-name ──────────────────────────────────────────┤ │ │ ├─ RHDCPINT ──────────────────────────────────────────────────────────────┤ │ │ ├─ STORAGE POOL ──────────────────────────────────────────────────────────┤ │ │ └─ SUBSCHEMA= subschema-name ───────────────────────────────┬─────────┬───┘ └ fib-opt ┘
Expansion of fib-opt
┌────────────────────────────────────────────────────────────────────┐ ►►─▼──┬──────────────┬──────────────────────────────────────────────────┴─────►◄ ├─ ALL ────────┤ ├─ RADIX ──────┤ ├─ NOFILES ────┤ └─ BOUNDFILES ─┘
Parameters
  • ALL
    Specifies that some commands display additional information about the DMCL or subschema entities reported. Currently supported by DMCL and FIB related reports.
  • AM=
    access-module-name
    Displays the contents of the RCMs included in an ACCESS MODULE and the IB50 built into the ACCESS MODULE.
  • AM PROGRAM=
    Displays a core dump of an ACCESS module.
  • BIND SQL SEGMENT=
    Displays the logical and physical attributes for areas, tables, constraints, and indexes for a segment of an SQL-defined database. The output is similar to that of the BIND SUBSCHEMA function.
    • segment-name
      Specifies the name of the segment that contains the SQL database areas.
    • DBNAME=
      database-name
      Specifies the name of the database that contains the segment where the catalog for the SQL definitions reside.
  • BIND SUBSCHEMA=
    Displays the logical and physical attributes of the subschema.
    • subschema-name
      Specifies the name of a subschema load module.
    • DBNAME=
      Required unless you are binding to an originally built release 10.x subschema that is being converted to Release 12.0 format.
    • database-name
      Specifies the name of a database.
  • BOUNDFILES
    Specifies that only files connected to bound areas are displayed. This option is available for FIB-related reports.
  • DATES=
    Displays the DATE/TIME stamps of the components of a specified load module.
    • load-module-name
      Specifies the name of a load module.
  • DATETIME
    Displays the current Date/Time.
  • DATETIME STAMP=
    Displays the external value of an internal date/time stamp.
    • hex-internal-datetime-stamp
      The 16 hexadecimal digits that make up the internal representation of the date/time stamp.
  • DBTABLE
    Displays the contents of the default DBNAME table that is associated with the DMCL.
  • DBTABLE=
    Displays the contents of the named DBNAME table.
    • dbtable-name
      Specifies the name of a DB table load module
  • DMCL
    Reports the contents of the current DMCL module.
    • ALL
      Optionally, produces the following information in addition to the standard information provided on the DMCL report:
      • The date each area definition was last updated
      • A history of the last date and time that an area was affected by a DCMT VARY DMCL command
    • SORTED
      Sorts DMCL information by area name.
    • SORTED PAGES
      Sorts DMCL information by page range.
    • RADIX
      Specifies that each area displays the number of bits reserved for a dbkey line number in hex. This replaces the Data Sharing flag value.
  • EXTERNAL DATETIME=
    external-datetime-value
    The 26 characters that make up the external representation of the date/time stamp. The format is yyyy-mm-dd-hh.mm.ss.ffffff.
    • yyyy specifies the year. yyyy must be an integer in the range 0001 through 9999.
    • mm specifies the month within the year. mm must be an integer in the range 01 through 12.
    • dd specifies the day within the month. dd must be an integer in the range 01 through 31.
    • hh specifies the hour on a 24-hour clock. hh must be an integer in the range 00 through 23.
    • mm specifies the number of minutes past the hour. mm must be an integer in the range 00 through 59.
    • ss specifies the number of seconds past the minute. ss must be an integer in the range 00 through 59.
    • ffffff specifies the number of millionths of a second past the specified second.
  • FIND=
    hex-string
    Displays the program name and offset into the program where the address was found. Hex-string is the 8 hexadecimal digits of the address to be searched for. The address must reside in one of the programs that reside in the PROGRAM POOL.
  • HELP
    Displays the parameters supported by the LOOK task.
  • LOAD=OPSYS
    Specifies that load modules are loaded from an operating system load library rather than from a dictionary load area. This statement affects the loading technique used by SUBSCHEMA, DATES, PROGRAM, and RCM PROGRAM statements, and when coded, must precede any of these statements.
  • NOFILES
    Suppresses the display of DMCL files, buffers, journals, and DBTABLE data. This option is available for FIB-related reports.
  • OPTION FLAGS
    Displays all the optional APARs that have been activated in the current RHDCOPTF module.
  • PROGRAM=
    Displays the DATE/TIME stamp of all the components that make up the load module. Also provides a core dump of the load module.
    • load-module-name
      Specifies the name of the load module.
  • PROGRAM POOL
    Displays the contents of the PROGRAM POOL. Shows the program name, entry point address, load address, use count, and size of the program.
  • RADIX
    Specifies that commands that display DMCL area information display the number of bits in a dbkey in hex that is reserved for a dbkey. This replaces the data sharing flag status.
  • RCM PROGRAM=
    Displays a core dump of an RCM MODULE.
  • RHDCPINT
    Displays a list of all products you can license with the product intent status if an RHDCPINT module is found in the library concatenation.
  • STORAGE POOL
    Displays the contents of the STORAGE POOL. Shows the storage address, storage size, task number that acquired the storage, owner of the storage, and storage type.
  • SUBSCHEMA=
    Displays the logical attributes of the subschema.
    • subschema-name
      Specifies the name of a subschema.
Usage
Input
Input to the IDMSLOOK utility consists only of statements to control the utility processing.
Output
The IDMSLOOK utility generates a printout listing that includes the requested reports.
Batch operating mode
You can execute the IDMSLOOK utility in local mode only.
Coding considerations
You can include multiple input statements in a single run of IDMSLOOK. However, each input statement must be on a separate line.
None of the statements are required.
Online processing
Most of the functions of IDMSLOOK can be executed online through the DC task code LOOK.
For more information about using DC tasks, see .
JCL Considerations
For more information about the JCL used to execute IDMSLOOK, see the section for your operating system in this topic.
Examples
Requesting subschema information
The following SUBSCHEMA statement directs IDMSLOOK to return a report on the subschema load module EMPSS01. The report will include information about the logical and physical attributes of the EMPSS01 subschema when it is bound to database name EMPDEMO.
bind subschema=empss01,dbname=empdemo
Requesting DMCL information
The following statement directs IDMSLOOK to report all information about a DMCL (page range, size, file mappings, and so on, and date and time history) and to sort the information by area name.
dmcl all sorted
Requesting a hexadecimal dump
The following PROGRAM statement directs IDMSLOOK to return a hexadecimal dump of the load module RTPRG001, with the date/time stamps of the object modules included in RTPRG001.
program=rtpgr001
Sample Output
IDMSLOOK starts a new page in the message listing for each input parameter statement processed in the run. At the top of the page, IDMSLOOK prints the parameter statement. Then IDMSLOOK prints the report requested by the statement.
Report requested by subschema
IDMSLOOK - Selection Parameter Follows: SUBSCHEMA=EMPSS01 EMPSS01 was #LOADed From --> APPLDICT Entry Point Offset +0 - Reentrant - AMODE 31 - RMODE ANY SUBSCHEMA=EMPSS01 Compiled=yyyy-mm-dd 15.24.58 Subschema Structure is Network and Unbound Area Name Segment ------------------ -------- EMP-DEMO-REGION n/a INS-DEMO-REGION n/a ORG-DEMO-REGION n/a Record Name Stored Rec ID Area Name Data Length Prefix Length Procedures --------------------------------- ------ ------ ------------------ ----------- ------------- -------------------- COVERAGE VIA 400 INS-DEMO-REGION 20 20 DENTAL-CLAIM VIA 405 INS-DEMO-REGION 936 12 DEPARTMENT CALC 410 ORG-DEMO-REGION 56 16 EMPLOYEE CALC 415 EMP-DEMO-REGION 120 72 EMPOSITION VIA 420 EMP-DEMO-REGION 32 24 EXPERTISE VIA 425 EMP-DEMO-REGION 12 20 HOSPITAL-CLAIM VIA 430 INS-DEMO-REGION 300 8 INSURANCE-PLAN CALC 435 INS-DEMO-REGION 132 8 JOB CALC 440 ORG-DEMO-REGION 300 24 IDMSCOMP Before STORE IDMSCOMP Before MODIFY IDMSDCOM After GET NON-HOSP-CLAIM VIA 445 INS-DEMO-REGION 1,056 12 OFFICE CALC 450 ORG-DEMO-REGION 76 16 SKILL CALC 455 ORG-DEMO-REGION 76 20 SR1 VIA 1 n/a 4 8 SR6 VIA 6 n/a 0 0 SR7 CALC 7 n/a 16 16 Chain Sorted-> CALC Next,Prior Owner -------> SR1 Next=00 Prior=04 Member ------> SR6 Next=00 Prior=04 Member ------> SR7 Next=00 Prior=04 Ckey Offset=16 Length=16 Data Type=Character Member ------> SKILL Next=00 Prior=04 Ckey Offset=20 Length=4 Data Type=Numeric (Unsigned) Member ------> OFFICE Next=00 Prior=04 Ckey Offset=16 Length=3 Data Type=Character Member ------> JOB Next=00 Prior=04 Ckey Offset=28 Length=4 Data Type=Numeric (Unsigned) Member ------> INSURANCE-PLAN Next=00 Prior=04 Ckey Offset=8 Length=3 Data Type=Character Member ------> EMPLOYEE Next=00 Prior=04 Ckey Offset=72 Length=4 Data Type=Numeric (Unsigned) Member ------> DEPARTMENT Next=00 Prior=04 Ckey Offset=16 Length=4 Data Type=Numeric (Unsigned) Chain Last --> COVERAGE-CLAIMS Next,Prior Owner -------> COVERAGE Next=12 Prior=16 Via Member --> NON-HOSP-CLAIM Next=00 Prior=04 Via Member --> HOSPITAL-CLAIM Next=00 Prior=04 Via Member --> DENTAL-CLAIM Next=00 Prior=04 Chain Sorted-> DEPT-EMPLOYEE Next,Prior,Owner Owner -------> DEPARTMENT Next=08 Prior=12 Member ------> EMPLOYEE Next=08 Prior=12 Owner=16 Ckey Offset=86 Length=15 Data Type=Character Ckey Offset=76 Length=10 Data Type=Character Chain First -> EMP-COVERAGE Next,Prior,Owner Owner -------> EMPLOYEE Next=32 Prior=36 Via Member --> COVERAGE Next=00 Prior=04 Owner=08 Chain First -> EMP-EMPOSITION Next,Prior,Owner Owner -------> EMPLOYEE Next=40 Prior=44 Via Member --> EMPOSITION Next=00 Prior=04 Owner=08 Chain Sorted-> EMP-EXPERTISE Next,Prior,Owner Owner -------> EMPLOYEE Next=48 Prior=52 Via Member --> EXPERTISE Next=00 Prior=04 Owner=08 Ckey Offset=20 Length=2 Data Type=Character Index Sorted-> EMP-NAME-NDX SR8Next,SR8Prior Owner -------> SR7 SR8Next=08 SR8Prior=12 Member ------> EMPLOYEE SR8Next=20 Ckey Offset=86 Length=15 Data Type=Character Ckey Offset=76 Length=10 Data Type=Character
Report requested by DMCL
For data sharing installations, the "Shr" column in the generated report can have one of the following values:
  • blank -- no data sharing enabled for area.
  • D -- data sharing has been defined in the DMCL definition of the area, but it is not currently being shared.
  • R -- data sharing is currently active for the identified area.
  • The RADIX option replaces the "Shr" column with a radix value.
IDMSLOOK - OPSYS=z/OS Version XX.XX.XX DMCL ALL DMCL=S74DMCL Runtime Size---> 13008 (77,832 Bytes) This DMCL uses dbtable R120DBTB Compiled Size---> 0BD7C (48,508 Bytes) Date Last Critical Change=2008-04-30 20.34.06 The Operating System is z/OS Date Created=2007-05-25 10.40.48 Date Last Updated=2008-04-30 18.00.39 Dynamic File Allocation - on Data Sharing is active - on connectivity no abend Data Sharing Lock Entries - 4,096 Data Sharing Members - 4 Data Sharing Default Shared Cache - IDMSCACHE00002 Memory Cache Location ANYWHERE Storage Limit OPSYS Page Low High Page Area Name Shr Group Page Page Size DDNAME ---------------------- --- ----- ---------- ---------- ------ -------- DBCR.BRNCHTEL 15 680,001 685,012 4,000 BRANCHA BRANCHB BRANCHC BRANCHD NETWORK area On STARTUP go Update On WARMSTART use current status Definition date last critical change=2007-05-25 10.40.48 Page Reserve size 0 Space Management Page Interval 1,984 Max Records Per Page 255 Page Range Symbolic is BRNCHTEL Value is 680,001--->685,012 DBCR.ACCTHIST 15 690,001 740,040 2,932 ACCOUNTA ACCOUNTB ACCOUNTC ACCOUNTD ACCOUNTE NETWORK area On STARTUP go Update On WARMSTART use current status Definition date last critical change=2007-05-25 10.40.48 Page Reserve size 0 Space Management Page Interval 1,450 Max Records Per Page 255 Page Range Symbolic is ACCTHIST Value is 690,001--->740,040 EMPDEMO.EMP-DEMO-REGION 0 75,001 75,100 4,276 EMPDEMO NETWORK area On STARTUP go Update On WARMSTART use current status Definition date last critical change=2007-05-25 10.40.48 Page Reserve size 0 Space Management Page Interval 2,122 Max Records Per Page 255 Page Range Symbolic is EMP-DEMO-REGION Value is 75,001--->75,100 EMPDEMO.INS-DEMO-REGION 0 75,101 75,150 4,276 INSDEMO NETWORK area On STARTUP go Update On WARMSTART use current status Definition date last critical change=2007-05-25 10.40.48 Page Reserve size 0 Space Management Page Interval 2,122 Max Records Per Page 255 Page Range Symbolic is INS-DEMO-REGION Value is 75,101--->75,150 EMPDEMO.ORG-DEMO-REGION 0 75,151 75,200 4,276 ORGDEMO NETWORK area On STARTUP go Update On WARMSTART use current status Definition date last critical change=2007-05-25 10.40.48 Page Reserve size 0 Space Management Page Interval 2,122 Max Records Per Page 255 Page Range Symbolic is ORG-DEMO-REGION Value is 75,151--->75,200 . . . Mem.- Shared File Name DDNAME Type Cache Cache Buffer Name --------------------------- -------- ---- ----- ----- ------------------ DBCR.ACCOUNTA ACCOUNTA BDAM No Yes DBCR_ACCT_BUFFER Definition date last critical change=2007-05-25 10.40.48 DBCR.ACCOUNTB ACCOUNTB BDAM No Yes DBCR_ACCT_BUFFER Definition date last critical change=2007-05-25 10.40.48 DBCR.ACCOUNTC ACCOUNTC BDAM No Yes DBCR_ACCT_BUFFER Definition date last critical change=2007-05-25 10.40.48 DBCR.ACCOUNTD ACCOUNTD BDAM No Yes DBCR_ACCT_BUFFER Definition date last critical change=2007-05-25 10.40.48 DBCR.ACCOUNTE ACCOUNTE BDAM No Yes DBCR_ACCT_BUFFER Definition date last critical change=2007-05-25 10.40.48 DBCR.BRANCHA BRANCHA BDAM No Yes DBCR_BRCH_BUFFER Definition date last critical change=2007-05-25 10.40.48 DBCR.BRANCHB BRANCHB BDAM No Yes DBCR_BRCH_BUFFER Definition date last critical change=2007-05-25 10.40.48 DBCR.BRANCHC BRANCHC BDAM No Yes DBCR_BRCH_BUFFER Definition date last critical change=2007-05-25 10.40.48 DBCR.BRANCHD BRANCHD BDAM No Yes DBCR_BRCH_BUFFER Definition date last critical change=2007-05-25 10.40.48 EMPDEMO.EMPDEMO EMPDEMO BDAM No No DEFAULT_BUFFER Definition date last critical change=2007-05-25 10.40.48 EMPDEMO.INSDEMO INSDEMO BDAM No No DEFAULT_BUFFER Definition date last critical change=2007-05-25 10.40.48 EMPDEMO.ORGDEMO ORGDEMO BDAM No No DEFAULT_BUFFER Definition date last critical change=2007-05-25 10.40.48 . . . DMCL Journals Page Size # of Pages ------------- ---------- ---------- SYSJRNL1 2,932 30,000 Definition date last critical change=2007-05-25 10.40.48 SYSJRNL2 2,932 30,000 Definition date last critical change=2008-04-30 17.57.03 SYSJRNL 19,068 Archive Journal Buffers Buffer Size # of Buffers --------------- ----------- ------------ JNL_BUFFER 2,932 80 Definition date last critical change=2007-05-25 10.40.48 Buffer CV CV Total CV Local Local Total Local DMCL Buffers Size Buffers Type Size Buffers Type Size ------------ ------ ------ -- ---------- ------ -- ---------- DBCR_BRCH_BUFFER 4,000 5,000 OS 20,000,000 1,000 OS 4,000,000 DBCR_ACCT_BUFFER 2,932 5,000 OS 14,660,000 1,000 OS 2,932,000 LOG_BUFFER 1,076 5 OS 5,380 5 DC 5,380 SCRATCH_BUFFER 2,676 5 OS 13,380 5 DC 13,380 DEFAULT_BUFFER 9,076 30 OS 272,280 20 OS 181,520 0 Bytes used for CV buffers in DC storage 94,951,040 Bytes used for CV buffers in OS storage 94,951,040 Bytes used for CV DMCL Buffers 18,760 Bytes used for LOCAL buffers in DC storage 19,113,520 Bytes used for LOCAL buffers in OS storage 19,132,280 Bytes used for LOCAL DMCL Buffers Dbtable=R120DBTB Compiled Date=2007-05-16 17.18.23 The DEFAULT Dictionary is TSTDICT DBNAME is *DEFAULT match on subschema is OPTIONAL Subschema IDMSNWK? maps to IDMSNWK? using DBNAME ---> TSTDICT Subschema EMPSS??? maps to EMPSS??? using DBNAME ---> EMPDEM2 Subschema EV?????? maps to EV?????? using DBNAME ---> VSAMTDB Subschema ET?????? maps to ETSTSUBS using DBNAME ---> ETOTDB Subschema DBCR???? maps to DBCR???? using DBNAME ---> DBCR DBNAME is DBCR match on subschema is OPTIONAL Include SEGMENT ---> DBCR 0 BIND COUNT DBNAME is EMPDEM2 match on subschema is OPTIONAL Include SEGMENT ---> EMPDEMO 0 BIND COUNT . . . IDMSLOOK - 1 Selection Card Processed
Display Component Module Information
The following LOOK command displays information about the component modules of program IDMSCHDC.
LOOK DATES=IDMSCHDC IDMSLOOK - OPSYS=z/OS Version XX.XX.XX DATES=IDMSCHDC was loaded From CDMSLIB DSN --> IDMSNDV.MOTM.IDMS.BASE.P2.LOADLIB Entry Point Offset +0 - Reentrant - AMODE 31 - RMODE ANY 31,016 Bytes in Load Module IDMSCHDC loaded at 38D1CA00 Module Offset Date Time FMID RMID IDMSFSED +18 100111 1645 CAGJI00 CAGJI00 IDDSFEDC +6080 100111 1637 CAGJI00 CAGJI00 IDMSCHPT +7408 100111 1640 CAGJI00 CAGJI00 IDMSDATE +7878 100111 1712 CAGJI00 CAGJI00
More Information