Previous Topic: How Schedule Manager Resolves Schedule ConflictsNext Topic: Example: REPORT Command


REPORT Command—Print Schedule Manager Data

While editing a schedule, issue the REPORT commands at the command line to save to disk the same schedule information that is displayed by the SHOW commands.

Similar to the SHOW commands, the following are the REPORT commands:

REPORT

Report the SHOW display currently being viewed in Edit.

REPORT CLOSE

Close the report data set and stop it from receiving any more REPORT output.

REPORT CONFLICTS

Report conflicts between periods.

REPORT LINKS

Report links between periods and system resources.

REPORT OPEN [dsn]

Open the specified dsn or default report data set.

REPORT OVERLAPS

Report overlapping periods.

REPORT STATES . . .

Report the scheduled state of all your system resources.

Note: All of the command options available on the SHOW STATES command are also available on the REPORT STATES command.

Issuing the REPORT command by itself without any command options results in Schedule Manager reporting the SHOW display currently being viewed.

The first REPORT command to be issued with or without any command options creates a default report data set that is named using the following template:

hlq.SM.opssysid.schstrip.Dyyymmdd.Thhmm

Following is a description of the values in this template:

hlq

The default value returned by the standard OPDSPF() REXX routine, or the TSO userid of the user if OPSDSPF() returns null.

Note: If OPDSPF() is not customized by the user, then it returns a default value of either the TSO PREFIX setting, if one exists, or the TSO userid of the user.

opssysid

The system ID of the CA OPS/MVS system on which the schedule resides.

schstrip

The leftmost eight non-blank characters of the schedule name excluding any underscore characters.

yyymmdd

The current date without the high-order year digit (millennium).

hhmm

The current time of day in 24-hour military time.

You may optionally specify your own report data set name by issuing the following command first before issuing any other REPORT commands:

REPORT OPEN datasetname

The datasetname may be specified with or without quotes (' or "). If the datasetname is specified without quotes, then it is prefixed by hlq as described above.

Any errors that occur while attempting to allocate either the default or user-specified report data set result in the Dataset Creation Attributes panel being displayed. From there you are able to alter the data set name for allocation re-try by Schedule Manager, or SWAP into another ISPF screen to allocate the data set using ISPF, batch JCL, TSO commands, and so on.

After the first REPORT command completes, the output from any subsequent REPORT commands issued are appended to the end of the same report data set. The report data set is closed after each REPORT command completes and can be viewed, printed, copied, edited, and so on.

To close the report data set and stop it from receiving any more REPORT output, the user must issue the following command:

REPORT CLOSE

Note: Issue the HELP command after the REPORT CLOSE command returns to display the name of the report data set that was closed.