APPLDISCOVER command

Syntax

To discover CICS fields that you can use as Primary and Secondary Groupings, the format is as follows:

To discover Db2 fields that can be used as Primary and Secondary Groupings, the format is as follows:

To discover IMS fields that can be used as Primary and Secondary Groupings, the format is as follows:

To discover MQ fields that can be used as Primary and Secondary Groupings, the format is as follows:

To discover WAS fields that can be used as Primary and Secondary Groupings, the format is as follows:

To discover fields that can be used to create Suites, the format is as follows:

Syntax explanations

• The SUBSYSTYPE parameter is required and defines the data source to which this command applies.
  • CICS—All CICS records
  • DB2—All Db2 records
  • IMS—All IMS records
  • MQ—All MQ records
  • WAS—All WAS records
  • BAT—All SMF type 30 records
• The SID parameter is optional and specifies a list of Logical System IDs or patterns of Logical System IDs to which this command applies. The default is All Logical Systems. The value found for SID is used as a key in the discovery data. To group all of the fields together without regard to the SID value, use the special keyword NONE for the SID value. The field length of the SID element is eight characters. You can code a total of 22 SIDs.
• The SUBSYS parameter is optional and specifies a list of IMS, MQ, or Db2 Subsystem names or patterns of Subsystem names to which this command applies. The default is All Subsystems. The value found for SUBSYS is used as a key in the discovery data. To group all of the fields together without regard to the SUBSYS value, use the special keyword NONE for the SUBSYS value. The field length of the SUBSYS element is eight characters. You can code a total of 22 SUBSYSs.
• The CICSREGION parameter is optional and specifies a list of CICS regions or patterns of CICS regions to which this command applies. The default is All CICS Regions. The value found for CICSREGION is used as a key in the discovery data. To group all of the fields together without regard to the CICSREGION value, use the special keyword NONE for the CICSREGION value. The functioning of this keyword is the same as that of keyword SUBSYS. They are interchangeable. The field length of the CICSREGION element is eight characters. You can code a total of 22 CICSREGIONs.
• The SERVER parameter is optional and specifies a list of WAS Server names or patterns to which this command applies. The default is All WAS Servers. The value found for SERVER is used as a key in the discovery data. To group all of the fields together without regard to the SERVER value, use the special keyword NONE for the SERVER value. The functioning of this keyword is the same as that of keyword SUBSYS. They are interchangeable. The field length of the SERVER element is eight characters. You can code a total of 22 SERVERs.
• The REGTYPE parameter is optional and specifies a list of IMS message types to which this command applies. The value used here must be one of the message types listed for an IMS Subsystem. If the message type has been combined, then use the name value used in the COMBINE command. REGTYPE and CONNTYPE are functionally equivalent and are interchangeable. Patterns may not be used. The value found for REGTYPE is used as a key in the discovery data. To group all of the fields together without regard to the REGTYPE value, use the special keyword NONE for the REGTYPE value. The field length of the REGTYPE element is eight characters. You can code a total of 22 REGTYPEs.
• The CONNTYPE parameter is optional and specifies a list of Db2 or MQ connection types to which this command applies. The value used here must be one of the connection types listed for a Db2 or an MQ Subsystem. If the connection type has been combined, then use the name value used in the COMBINE command. CONNTYPE and REGTYPE are functionally equivalent and are interchangeable. Patterns may not be used. The value found for CONNTYPE is used as a key in the discovery data. To group all of the fields together without regard to the CONNTYPE value, use the special keyword NONE for the CONNTYPE value.
• The SUBTYPE parameter refers to the record subtype of the SMF 30 records. The SMF 30 subtype number is used as a key in the discovery data. To group all of the fields together without regard to the record subtype, use the special keyword NONE for the SUBTYPE number. The valid values for SUBTYPE are 1 through 6.
• The CONTAINER parameter is optional and specifies the WAS container type, either WEB or J2EE. To group all of the fields together without regard to the CONTAINER value, use the special keyword NONE for the CONTAINER value.

• The REPORT parameter creates a report in the UIE summary file. The default value for REPORT is YES. The report consists of the data type (such as CICS, Db2, and so on), the system ID (such as SYSA), a subsystem name or CICS region name, the connection, region, or subtype of the record, and the field name label. This header is followed by the list of values found in the data with an occurrence count for each value. For example:

  SUBSYSTYPE=DB2, SID=SYSA, SUBSYS=DB2P, CONNTYPE=IMSMPP, FIELD=PSB

  Count and PSB value	Count and PSB value	Count and PSB value	Count and PSB value
  3 PSBAA010	31 PSBAA020	861 PSBAA034	1770 PSBAA041
  5 PSBAA100	2 PSBAA102	3 PSBAA105	64 PSBAA200
  86 PSBAA202	51 PSBAA203	92 PSBAA204	84 PSBAA206
  83 PSBAA207	3 PSBAA208	44 PSBAA212	118 PSBAA245
  21 PSBAA353	1316 PSBAA362	762 PSBAA370	10 PSBAA397
  16 PSBAA503	821 PSBAA601	10 PSBAA702	8 PSBAA904

• The FILE parameter generates a flat file of the discovery data when YES is coded. The data is written to DDNAME DISCFILE, which must be present in the JCL for the job. The data set should be allocated as RECFM=VB, LRECL=27984, BLKSIZE=27988, although the actual record length is currently 108 bytes. The record is defined as follows:

  FILE parameter definers	Type	Description
  TYPE	CHAR(8)	DB2/CICS/IMS/MQ/JOB/WAS
  FIRST_DATE	CHAR(10)	SMF header date of the first record with this field (yyyy-mm-dd)
  FIRST_TIME	CHAR(8)	SMF header time of the first record with this field (hh:mm:ss)
  LAST_DATE	CHAR(10)	SMF header date of the last record with this field (yyyy-mm-dd)
  LAST_TIME	CHAR(8)	SMF header time of the last record with this field (hh:mm:ss)
  SYSID	CHAR(8)	System ID
  SUBSYS_ID	CHAR(8)	Subsystem name or CICS region
  CONN	CHAR(8)	Connection/Region type/SMF Subtype
  FIELD_NAME	CHAR(8)	Name of the field
  FIELD_VALUE	CHAR(24)	The value in the field truncated at 24 characters
  OCC_COUNT	FLOAT(21)	The number of times this value occurred for this field in float format
  OCC_FIXED	BINARY	The number of times this value occurred for this field in binary format

• The PC parameter generates a comma-delimited file of the discovery data when the value is YES. The data is written to the DDNAME DISCPC, which must be present in the JCL for the job. The data set should be allocated as RECFM=VB, LRECL=27984, BLKSIZE=27988. The comma-delimited file has a similar format as the flat file, except that the field values end with a comma and the two count fields are in character format. You can download this file to your PC and then input it to the appropriate application, such as Excel.
• The SHOWBLANK parameter provides a display of fields that contain all spaces. The field is shown as _BLANK_ with a count of the number of times this field contained spaces. The default for this flag is NO--do not show blank field values.
• The SHOWHEX00 parameter provides a display of fields that contain hex 00. The field is shown as _HEX00_ with a count of the number of times this field contained zeros. The default for this flag is NO--do not show hex 00 field values.
• The SHOWNULL parameter provides a display of fields that would appear in sections that have a null pointer. The field will be shown as _NULL_ with a count of the number of times the field could not be located because the section pointer was null. The default for this flag is NO.
• The FIELDS parameter is required and specifies a list of fields to be extracted. The field names can be only those that are listed in the following examples. A value of LIST creates a field list in the summary report of valid field values. For a definition of each field name, see Subsystem-transaction-grouping-field-definitions.

• The field values for CICS are:

  CICS field values
  ALL	STANDARD	JOB	NONE	PROGRAM	TERM
  TRAN	TRANTYPE	USERFLD	USERID	110	ABCODEC
  ABCODEO	ACTVTYID	ACTVTYNM	BRDGTRAN	CBSRVRNM	CLIPADDR
  FCTYNAME	LUNAME	NETID	NETUOWPX	NETUOWSX	OTSTID
  PGMNAME	PRCSID	PRCSNAME	PRCSTYPE	RLUNAME	RMUOWID
  RPTCLSNM	RRMSURID	RSYSID	RTYPE	SRVCLSNM	TRANFLAG
  TCLSNAME	TCPSRVCE	TERMCNNM	TRANPRI	TRNGRPID	TTYPE
  MVCICS	T6E$SYS	T6EABCD	T6EACTID	T6EACTNM	T6EAPLID
  T6EAUTH	T6EBMSN	T6EBRTID	T6ECIREL	T6ECORR	T6EDB2AL
  T6EDB2P	T6EDB2SS	T6EDTRID	T6EFCTY	T6EMVREL	T6ENETID
  T6ENETNM	T6EOPID	T6EORIG	T6EOTSID	T6EPGNM	T6EPRCSD
  T6EPRCSN	T6EPRCST	T6EPSBN	T6ERLUNM	T6ERMUOW	T6ERPTCL
  T6ERSYS	T6ESAPAC	T6ESAPLT	T6ESAPMN	T6ESAPTM	T6ESAPTY
  T6ESAPWA	T6ESIPAD	T6ESMFID	T6ESRVCL	T6ETCLNM	T6ETCPSV
  T6ETECNM	T6ETGPID	T6ETMID	T6ETRID	T6EUDATA	T6EUOW
  T6EURID	T6EUSER	TMON	LMRKJOBN	TAABNCDE	TABENDPG
  TACICLVL	TADBCJOB	TADBCSYS	TADB2ID	TAGROUP	TAJOBID
  TALUOWID	TAMQQMGR	TAMVSID	TANETLNM	TAOPRID	TAOTRAN
  TAPGM1	TAPTRAN	TARMTSYS	TASMFSID	TASYSID	TATERID
  TATRMRMT	TAUOWCTM	TAUOWLNM	TAUOWNUM	TAUSER	TAUSERID
  TAVTMID	TAWMLOAD	TAWMRPTC	TAWMSRVC	TAXMCLAS	USERFLD2
  USERFLD3	USERFLD4

  Warning

  Important

  For the CICS 110 record user field:

  • USERFLD—displays characters 1 - 64
  • USERFLD2—displays characters 65 - 128
  • USERFLD3—displays characters 129 - 192
  • USERFLD4—displays characters 193 - 256

  ALL will generate the following field values:

  ALL field values (CICS)
  JOB	NONE	PROGRAM	TERM	TRAN	TRANTYPE
  USERFLD	USERID	ABCODEC	ABCODEO	ACTVTYID	ACTVTYNM
  BRDGTRAN	CBSRVRNM	CLIPADDR	FCTYNAME	LUNAME	NETID
  OTSTID	PGMNAME	PRCSID	PRCSNAME	PRCSTYPE	RLUNAME
  RPTCLSNM	RRMSURID	RSYSID	RTYPE	SRVCLSNM	TRANFLAG
  TCLSNAME	TCPSRVCE	TERMCNNM	TRANPRI	TTYPE	T6E$SYS
  T6EABCD	T6EACTID	T6EACTNM	T6EAPLID	T6EAUTH	T6EBMSN
  T6EBRTID	T6ECIREL	T6ECORR	T6EDB2AL	T6EDB2P	T6EDB2SS
  T6EDTRID	T6EFCTY	T6EMVREL	T6ENETID	T6ENETNM	T6EOPID
  T6EORIG	T6EOTSID	T6EPGNM	T6EPRCSD	T6EPRCSN	T6EPRCST
  T6EPSBN	T6ERLUNM	T6ERPTCL	T6ERSYS	T6ESAPAC	T6ESAPLT
  T6ESAPMN	T6ESAPTM	T6ESAPTY	T6ESAPWA	T6ESIPAD	T6ESMFID
  T6ESRVCL	T6ETCLNM	T6ETCPSV	T6ETECNM	T6ETGPID	T6ETMID
  T6ETRID	T6EUDATA	T6EUSER	LMRKJOBN	TAABNCDE	TABENDPG
  TACICLVL	TADBCJOB	TADBCSYS	TADB2ID	TAGROUP	TAJOBID
  TAMQQMGR	TAMVSID	TANETLNM	TAOPRID	TAOTRAN	TAPGM1
  TAPTRAN	TARMTSYS	TASMFSID	TASYSID	TATERID	TATRMRMT
  TAUOWLNM	TAUSER	TAUSERID	TAVTMID	TAWMLOAD	TAWMRPTC
  TAWMSRVC	TAXMCLAS

  STANDARD will generate the following field values:

  STANDARD field values (CICS)
  JOB	NONE	PROGRAM	TERM	TRAN	TRANTYPE
  USERFLD	USERID

  110 will generate the following field values:

  110 field values (CICS)
  ABCODEC	ABCODEO	ACTVTYID	ACTVTYNM	BRDGTRAN	CBSRVRNM
  CLIPADDR	FCTYNAME	LUNAME	NETID	OTSTID	PGMNAME
  PRCSID	PRCSNAME	PRCSTYPE	RLUNAME	RPTCLSNM	RRMSURID
  RSYSID	RTYPE	SRVCLSNM	TRANFLAG	TCLSNAME	TCPSRVCE
  TERM	TERMCNNM	TRAN	TRANPRI	TTYPE	USERID

  BMC AMI Ops Monitor for CICS will generate the following field values:

  BMC AMI Ops Monitor for CICS field values
  T6E$SYS	T6EABCD	T6EACTID	T6EACTNM	T6EAPLID	T6EAUTH
  T6EBMSN	T6EBRTID	T6ECIREL	T6ECORR	T6EDB2AL	T6EDB2P
  T6EDB2SS	T6EDTRID	T6EFCTY	T6EMVREL	T6ENETID	T6ENETNM
  T6EOPID	T6EORIG	T6EOTSID	T6EPGNM	T6EPRCSD	T6EPRCSN
  T6EPRCST	T6EPSBN	T6ERLUNM	T6ERPTCL	T6ERSYS	T6ESAPAC
  T6ESAPLT	T6ESAPMN	T6ESAPTM	T6ESAPTY	T6ESAPWA	T6ESIPAD
  T6ESMFID	T6ESRVCL	T6ETCLNM	T6ETCPSV	T6ETECNM	T6ETGPID
  T6ETMID	T6ETRID	T6EUDATA	T6EUSER

  TMON will generate the following field values:

  TMON field values (CICS)
  LMRKJOBN	TAABNCDE	TABENDPG	TACICLVL	TADBCJOB	TADBCSYS
  TADB2ID	TAGROUP	TAJOBID	TAMQQMGR	TAMVSID	TANETLNM
  TAOPRID	TAOTRAN	TAPGM1	TAPTRAN	TARMTSYS	TASMFSID
  TASYSID	TATERID	TATRMRMT	TAUSER	TAUSERID	TAVTMID
  TAWMLOAD	TAWMRPTC	TAWMSRVC	TAXMCLAS

  The following fields are excluded from the groupings because they represent a record identifier and are unique to an individual record. You can request these fields for the Discovery run by specifying the field name in the FIELDS parameter. The excluded fields are:

  • For 110 records—NETUOWPX, NETUOWSX, RMUOWID, TRNGRPID
  • For BMC AMI Ops Monitor for CICS records—T6EUOW, T6ERMUOW, T6EURID
  • For TMON records—TAUOWLNM, TAUOWCTM, TAUOWNUM, TALUOWID

• The field values for Db2 are:

  Db2 field values
  ALL	STANDARD	AUTH	CORR	CORRASIS	EUID
  EUTRAN	EUWS	JOB	LOCATION	NONE	OPER
  PACKAGE	PLAN	PSB	101	QLAC	QLACLOCN
  QLACPRID	QMDA	QMDAACCT	QMDAAINF	QMDAAPPL	QMDAASTR
  QMDAATID	QMDAAUTH	QMDACNAM	QMDACORR	QMDACTYP	QMDAINFO
  QMDALOCN	QMDALUNM	QMDANETN	QMDAPLAN	QMDAPLAT	QMDAPMOD
  QMDAPREL	QMDAPRID	QMDAPTYP	QMDAPVER	QMDASQLI	QMDASUFX
  QPAC	QPACAANM	QPACASCH	QPACCOLN	QPACCONT	QPACLOCN
  QPACPKID	QPACPKNM	QWAC	QWACNID	QWACWLME	QWDA
  QWDAXCQO	QWHA	QWHADSGN	QWHAMEMN	QWHC	QWHCAID
  QWHCCN	QWHCCV	QWHCEUID	QWHCEUTX	QWHCEUWN	QWHCOAUD
  QWHCOPID	QWHCPLAN	QWHCROLE	QWHCTCXT	QWHCTOKN	QWHD
  QWHDPRID	QWHDRQNM	QWHDSVNM	QWHDTSTP	QWHS	QWHSLOCN
  QWHSLUNM	QWHSLWID	QWHSNID	SAPTRAN	SAPUID	SAPWP
  SAPWPID	SAPWPNUM	SAPWPTYP	TRAN	TYPE

  ALL will generate the following values:

  ALL field values (Db2)
  AUTH	CORR	CORRASIS	EUID	EUTRAN	EUWS
  JOB	LOCATION	NONE	OPER	PACKAGE	PLAN
  PSB	QLACLOCN	QLACPRID	QMDAACCT	QMDAAINF	QMDAAPPL
  QMDAASTR	QMDAATID	QMDAAUTH	QMDACNAM	QMDACORR	QMDACTYP
  QMDAINFO	QMDALOCN	QMDALUNM	QMDANETN	QMDAPLAN	QMDAPLAT
  QMDAPMOD	QMDAPREL	QMDAPRID	QMDAPTYP	QMDAPVER	QMDASQLI
  QMDASUFX	QPACAANM	QPACASCH	QPACCOLN	QPACLOCN	QPACPKID
  QPACPKNM	QWACWLME	QWDAXCQO	QWHADSGN	QWHAMEMN	QWHCAID
  QWHCCN	QWHCCV	QWHCEUID	QWHCEUTX	QWHCEUWN	QWHCOAUD
  QWHCOPID	QWHCPLAN	QWHCROLE	QWHCTCXT	QWHDPRID	QWHDRQNM
  QWHDSVNM	QWHSLOCN	QWHSLUNM	QWHSNID	SAPTRAN	SAPUID
  SAPWP	SAPWPID	SAPWPNUM	SAPWPTYP	TRAN	TYPE

  STANDARD will generate the following field values:

  STANDARD field values (Db2)
  AUTH	CORR	CORRASIS	EUID	EUTRAN	EUWS
  JOB	LOCATION	NONE	OPER	PACKAGE	PLAN
  PSB	SAPTRAN	SAPUID	SAPWP	SAPWPID	SAPWPNUM
  SAPWPTYP	TRAN	TYPE

  101 will generate the following field values:

  101 field values (Db2)
  QLACLOCN	QLACPRID	QMDAACCT	QMDAAINF	QMDAAPPL	QMDAASTR
  QMDAATID	QMDAAUTH	QMDACNAM	QMDACORR	QMDACTYP	QMDAINFO
  QMDALOCN	QMDALUNM	QMDANETN	QMDAPLAN	QMDAPLAT	QMDAPMOD
  QMDAPREL	QMDAPRID	QMDAPTYP	QMDAPVER	QMDASQLI	QMDASUFX
  QPACAANM	QPACASCH	QPACCOLN	QPACLOCN	QPACPKID	QPACPKNM
  QWACWLME	QWDAXCQO	QWHADSGN	QWHAMEMN	QWHCAID	QWHCCN
  QWHCCV	QWHCEUID	QWHCEUTX	QWHCEUWN	QWHCOAUD	QWHCOPID
  QWHCPLAN	QWHCROLE	QWHCTCXT	QWHDPRID	QWHDRQNM	QWHDSVNM
  QWHSLOCN	QWHSLUNM	QWHSNID

QLAC will generate the following field values:

• QLACLOCN, QLACPRID

QMDA will generate the following field values:

QPAC will generate the following field values when APPLCONTROL specifies PACKAGE=YES:

• QPACAANM, QPACASCH, QPACCOLN, QPACLOCN, QPACPKID, QPACPKNM

QWAC will generate the following field values:

• QWACWLME

QWDA will generate the following field values:

• QWDAXCQO

QWHA will generate the following field values:

• QWHADSGN, QWHAMEMN

QWHC will generate the following field values:

QWHD will generate the following field values:

• QWHDPRID, QWHDRQNM, QWHDSVNM, QWHDTSTP

QWHS will generate the following field values:

• QWHSLOCN, QWHSLUNM, QWHSLWID, QWHSNID

  The following fields are excluded from the groupings because they represent a record identifier and are unique to an individual record. You can request these fields for the Discovery run by specifying the field name in the FIELDS parameter. The excluded fields are:

  • QWACNID, QWHCTOKN, QWHSLWID, QWHDTSTP, QPACCONT

  Some fields are relevant only to certain connection types or Db2 releases. If a field is requested that is not applicable, then the field will not appear in the requested output medium.

  The Discovery process turns on Db2 package processing in the event that package fields (QPAC) are requested. This process modifies the record counts for Db2 in the summary file to include the number of packages. If package information is not being requested, and the Db2 record counts in the summary file are important, then use the command SETOPTION DISCOVERNOPACKAGE to turn off the processing of package data.

• The field values for IMS are:

  IMS field values
  ALL	STANDARD	AUTH	CLASS	JOB	LTERM
  NODE	NONE	PSB	SECUR	TRAN	TYPE
  MVIMS	TRNAGN	TRNCODE	TRNESSID	TRNJOBNM	TRNLOGID
  TRNLTERM	TRNPGMNM	TRNPSBNM	TRNRCODE	TRNSMQGN	TRNUALTN
  TRNUMSWT	TRNUOW	TRNUSER	TRNUSID	TRNVNODE	TRNWLMSC
  TRNXCODE

  ALL will generate the following field values:

  ALL field values (IMS)
  AUTH	CLASS	JOB	LTERM	NODE	NONE
  PSB	SECUR	TRAN	TYPE	TRNAGN	TRNCODE
  TRNESSID	TRNJOBNM	TRNLOGID	TRNLTERM	TRNPGMNM	TRNPSBNM
  TRNRCODE	TRNSMQGN	TRNUALTN	TRNUMSWT	TRNUSER	TRNUSID
  TRNVNODE	TRNWLMSC	TRNXCODE

  STANDARD will generate the following field values:

  STANDARD field values (IMS)
  AUTH	CLASS	JOB	LTERM	NODE	NONE
  PSB	SECUR	TRAN	TYPE

  BMC AMI Ops Monitor for IMS Offline will generate the following field values:

  BMC AMI Ops Monitor for IMS Offline field values
  TRNAGN	TRNCODE	TRNESSID	TRNJOBNM	TRNLOGID	TRNLTERM
  TRNPGMNM	TRNPSBNM	TRNRCODE	TRNSMQGN	TRNUALTN	TRNUMSWT
  TRNUSER	TRNUSID	TRNVNODE	TRNWLMSC	TRNXCODE

  The following field is excluded from the groupings because it represents a record identifier and is unique to an individual record. You can request this field for the Discovery run by specifying the field name in the FIELDS parameter. The excluded field is:

  • TRNUOW

• The field values for MQ are:

  MQ field values
  ALL	STANDARD	116	AUTH	CORR	CORRASIS
  JOB	MVSUID	NONE	PSB	TRAN	TYPE
  QWACNID

  ALL will generate the following field values:

  ALL field values (MQ)
  AUTH	CORR	CORRASIS	JOB	MVSUID	NONE
  PSB	TRAN	TYPE

  STANDARD will generate the following field values:

  STANDARD field values (MQ)
  AUTH	CORR	CORRASIS	JOB	MVSUID	NONE
  PSB	TRAN	TYPE

  116 will generate the following field values. However, note that this value is currently excluded. See the next paragraph.

• QWACNID

  The following field is excluded from the groupings because it represents a record identifier and is unique to an individual record. You can request this field for the Discovery run by specifying the field name in the FIELDS parameter. The excluded field is:

  • QWACNID

• The field values for WAS are:

  WAS field values
  ALL	STANDARD	AMCNAME	METHOD	NONE	SERVLET
  WARNAME

  • ALL will generate the following field values:

    AMCNAME, METHOD, NONE, SERVLET, WARNAME

  • STANDARD will generate the following field values:

    AMCNAME, METHOD, NONE, SERVLET, WARNAME

• The field values that may be used for BATCH are:

  BATCH field values
  ALL	STANDARD	ACCT	CLASS	JOB	PG
  RACFGRP	RACFUSER	RCL	SCL

  ALL will generate the following field values:

  ALL field values
  ACCT	CLASS	JOB	PG	RACFGRP	RACFUSER
  RCL	SCL

  STANDARD will generate the following field values:

  STANDARD field values
  ACCT	CLASS	JOB	PG	RACFGRP	RACFUSER
  RCL	SCL

• The syntax <field>(start:length) enables you to discover only a part of a given field. For example, ACCT(11:8) produces a value containing 8 characters extracted from the ACCT field, starting at the eleventh character. Start represents the starting character column within the field relative to 1, and length is the number of characters to use. When start is omitted, 1 is assumed, such that (1:3) AND (:3) are equivalent expressions. When length is omitted, the value is obtained starting with the start character and continuing until the end of the field is reached or the end of the receiving field is reached. The length value is not checked for validity other than the fact that it must be a numeric value. This structure can be used on any valid field name.

  For example, the WAS METHOD field can be up to 512 bytes in length. Because the maximum length of the field value that can be captured is 24 characters, the METHOD field can be listed multiple times with different start columns. If the maximum value in the METHOD field is 100 characters, the following FIELDS values can used to display the entire value.

  FIELDS=METHOD(1:24),METHOD(25:24),METHOD(49:24),METHOD(73:24),METHOD(97:3)

  In addition, using SHOWBLANK=NO will present only the parts of the METHOD field that contain non-blank characters.

Examples

• To execute the standard Discovery option, specify the following command:

  SETOPTION DISCOVER

  This will set the run to Discovery and generate the following commands internally to extract the standard set of fields for each subsystem type:

  APPLDISCOVER SUBSYSTYPE=CICS REPORT=YES FILE=YES PC=YES FIELDS=STANDARD
  APPLDISCOVER SUBSYSTYPE=DB2 REPORT=YES FILE=YES PC=YES FIELDS=STANDARD
  APPLDISCOVER SUBSYSTYPE=IMS REPORT=YES FILE=YES PC=YES FIELDS=STANDARD
  APPLDISCOVER SUBSYSTYPE=MQ REPORT=YES FILE=YES PC=YES FIELDS=STANDARD
  APPLDISCOVER SUBSYSTYPE=WAS REPORT=YES FILE=YES PC=YES FIELDS=STANDARD
  APPLDISCOVER SUBSYSTYPE=BAT REPORT=YES FILE=YES PC=YES FIELDS=STANDARD

• To run a full Discovery for all fields for all subsystems, specify the following command:

  SETOPTION DISCOVERALL

  This will set the run to Discovery and generate the following commands internally:

  APPLDISCOVER SUBSYSTYPE=CICS REPORT=YES FILE=YES PC=YES FIELDS=ALL
  APPLDISCOVER SUBSYSTYPE=DB2 REPORT=YES FILE=YES PC=YES FIELDS=ALL
  APPLDISCOVER SUBSYSTYPE=IMS REPORT=YES FILE=YES PC=YES FIELDS=ALL
  APPLDISCOVER SUBSYSTYPE=MQ REPORT=YES FILE=YES PC=YES FIELDS=ALL
  APPLDISCOVER SUBSYSTYPE=WAS REPORT=YES FILE=YES PC=YES FIELDS=ALL
  APPLDISCOVER SUBSYSTYPE=BAT REPORT=YES FILE=YES PC=YES FIELDS=ALL

• To bypass the collection of Db2 package data information to avoid the count inflation caused by package processing, specify the following command:

  SETOPTION DISCOVERNOPACKAGE

• To run the Discovery option in addition to a regular UIE run to build a model and/or Visualizer file, specify the following commands:

  SETOPTION DISCOVERANDRUN
  APPLDISCOVER SUBSYSTYPE=subtype fields=<STANDARD/ALL/field list>

  At least one APPLDISCOVER command is required and it must specify which fields are to be extracted. Be careful when you use this command. The amount of resources used by the UIE batch job will increase significantly.

When DISCOVER processing has been invoked, the following message is displayed in the summary file:

When all of the input data has been read and the requested DISCOVER information files have been created, the job will end with the following message:

The following message will be displayed in the summary file when the SETOPTION DISCOVERANDRUN command is used.