VISFILE

Syntax

Syntax explanations

• TYPE=NONE indicates that you do not want to create a Visualizer file.
• GMTOFF=<offset> indicates that for your Visualizer file timestamps, you want to use a different GMT offset from the offset specified or used by default in the SDATE command.
• EXCLUDETBL=<comma-separated list> indicates that you would like to exclude the specified Visualizer table(s) to decrease the size of the VISFILE. Possible values are: JOBS, APPLDETAIL, DEVICEDETAIL, CHANNELS, STORSUB.

• INCLUDETBL=<comma-separated list> indicates that you would like to create additional Visualizer tables. Possible values are DEVTOP, JOBD, SUBSYSDSN, SUITEDSN, TRANDETAIL, and WKLTOP.

  • DEVTOP indicates that UIE can generate the DASD top 10 tables DEVTOP10, DEVRES10, DEVIOS10, and DEVACT10. Because these tables require extra resources to create and sort the data, they are not created by default.

  • JOBD indicates that UIE can generate a new Dynamic Job table. This table contains information similar to the JOBS table. The difference is that in the JOBS table, each job, no matter how long, is represented by one record, but in the JOBD table the activity of each job, in each Visualizer interval, is represented by a separate record. This enables you to compare CPU consumption for different jobs for a particular interval.

    Visualizer uses the JOBD table to create several new graphs, such as:

    • Most Active Jobs in Selected System(s)
    • Most Active jobs in Selected Suite(s)
    • Most Active Jobs in Selected Service Class(es)
    • Most Active Jobs in Selected Report Class(es)

    Note

    Specify the JOBD parameter if you want to collect information for use in Job/STC reports in the BMC AMI Cost Management product.

  • SUBSYSDSN indicates that UIE can generate a Subsystem by Data Set table. This table contains information about the data sets being used by each subsystem. Because this table can be very large, it is not created by default.
  • SUITEDSN indicates that UIE can generate a Suite by Data Set table. This table contains information about the data sets being used by each suite. Because this table can be very large, it is not created by default.
  • TRANDETAIL indicates that UIE can generate a new Application Transaction table. This table contains detailed information about each transaction in each application. Transaction is defined as:
    • CICS—Transaction name
    • DB2—Based on the connection type, this is the correlation ID for subsystem types, plan name for non subsystem types
    • IMS—PSBname
    • MQ—Correlation ID
  • WKLTOP indicates that UIE can generate the Workload top 10 tables RPGTOP10 and WKLTOPD. Because these tables require extra resources to create and sort the data, they are not created by default.

  Note

  Subsystem transaction IDs may contain special characters, including the following values:

  $ @ # . / - _ % & ? ! : | " = ¬ , ; < >

  Special characters contained in a transaction name are written to the Visualizer file with the exception of the comma, which is a reserved character for the Automator population process. A comma is converted to a left curly bracket { when the transaction name is written to the Visualizer file.  

  Note

  If you have a large number of unique transactions, the transaction detail option can generate a large volume of data. This results in a larger Visualizer file and a larger Visualizer database. You can also specify that UIE only create transaction detail for specific applications. For more information, see APPL.

• The JOBD table can be very large, therefore, it is not created by default.

  Note

  You can use commands CUTJOBDURN and CUTJOBCPU to decrease the size of JOBD table. The CUTJOBDURN and CUTJOBCPU parameters are applied to the whole job, not just to the activity in an individual interval.

Rules

If the GMTOFF=<offset> parameter is not used, it is assumed to be the same as the SDATE command.

Examples

By default, UIE generates interval timestamps in the VISFILE with the same GMT offset, which was specified in the SDATE command or used by default. However, at times, you might need to generate VISFILE timestamps with a different GMT offset. For that purpose, you can use the GMTOFF parameter. This parameter does not affect the specification of the processing interval, which is defined by the SDATE, STIME, EDATE, and ETIME commands.