MONITOR

Parameters

BINARY

Specifies that you do not want the Compare and Synchronize Monitor to perform any EBCDIC/ASCII translation. This option is useful if you have a PDS containing binary data, and is only available if you have set dataset-type to PDS or PARTITIONED. Synchronization of binary members is based on time stamps.

direction

The directions that the Compare and Synchronize Monitor is to monitor. This can be one of:

• NONE

  Monitor, but do not allow an upload or download to occur. This produces a report only.

• DOWNLOAD

  Monitor, but do not allow an upload to occur. This will allow download synchronization to occur.

• UPLOAD

  Monitor, but do not allow a download to occur. This will allow upload synchronization to occur. This option is not applicable if dataset-type is VSAM-KSDS, VSAM-KSDS-FIXED, VSAM-ESDS, VSAM-ESDS-FIXED, VSAM-RRDS or VSAM-RRDS-FIXED.

• BOTH

  Monitor, and allow both uploads and downloads to occur. This option is not applicable if dataset-type is VSAM-KSDS, VSAM-KSDS-FIXED, VSAM-ESDS, VSAM-ESDS-FIXED, VSAM-RRDS or VSAM-RRDS-FIXED.

filter

A specific member name or filter characters to specify a collection of members to be monitored. You can embed the filter characters with any other characters for pattern matching of the member name, similar to the usage of the wildcard characters on the workstation dir command:

• * any character may follow
• ? any character in this position
• + the character in this position must be non-blank
• - the character in this position must be a blank
• / the character in this position must be numeric
• \ the character in this position must be non-numeric

The value for filter can be from 1 to 16 characters long.

This parameter is optional when dataset-type is PDS (or PARTITIONED), LIBRARIAN, PANVALET and ENDEVOR, and is not applicable when dataset-type is set to anything else.

dataset-type

The type of the mainframe data set for which a monitoring relationship is to be built. This can be one of:

• PDS

  Partitioned data set. Specifying PARTITIONED has the same effect as specifying PDS.

• LIBRARIAN

  Computer Associates Librarian data set.

• PANVALET

  Computer Associates Panvalet data set.

• ENDEVOR

  Computer Associates Endevor data set.

• SEQUENTIAL

  Sequential data set.

• VSAM-KSDS

  Keyed (VSAM KSDS) data set. You cannot use MONITORPVCS when dataset-type is set to VSAM-KSDS.

  Set dataset-type to VSAM-KSDS if you want to monitor Innovation Access Method (IAM) files.

• VSAM-ESDS

  Entry (VSAM ESDS) data set. You cannot use MONITORPVCS when dataset-type is set to VSAM-ESDS.

• VSAM-RRDS

  Relative (VSAM RRDS) data set. You cannot use MONITORPVCS when dataset-type is set to VSAM-RRDS.

• VSAM-KSDS-FIXED

  Keyed (VSAM KSDS) data set, where the resulting imported file is converted to Micro Focus format in fixed format, with the minimum record length set to the maximum record length. You cannot use MONITORPVCS when dataset-type is set to VSAM-KSDS-FIXED.

• VSAM-ESDS-FIXED

  Entry (VSAM ESDS) data set, where the resulting imported file is converted to Micro Focus format in fixed format, with the minimum record length set to the maximum record length. You cannot use MONITORPVCS when dataset-type is set to VSAM-ESDS-FIXED.

• VSAM-RRDS-FIXED

  Relative (VSAM RRDS) data set, where the resulting imported file is converted to Micro Focus format in fixed format, with the minimum record length set to the maximum record length. You cannot use MONITORPVCS when dataset-type is set to VSAM-RRDS-FIXED.

drive:\directory\*.ext

When using MONITOR, specify the fully qualified path and name of the workstation files to complete the monitor relationship. You must specify the specific extension, such as *.CBL, to be monitored against.

If you specify the extension as three asterisks (***), the download initially downloads the file with no extension. If the file extension is then changed, the next synchronization operation finds the first matching filename with any extension. Only one file with the same filename can exist in the target directory. For example, if a host PDS member name is ACCTOPEN and no file with the prefix ACCTOPEN exists in the PC target directory, the file is downloaded as ACCTOPEN. If the extension is then modified to ACCTOPEN.CBL, the next synchronization detects the target filename as ACCTOPEN.CBL and synchronizes against that.

When using MONITORPVCS, specify the fully qualified location of a PVCS archive configuration file to complete the monitor relationship. This is the name of the archive in the usual archivename.cfg format.

mainframe-parameters

Parameters defining the data sets on the mainframe. The parameters to be specified vary depending on the setting of dataset-type:

• When dataset-type is PDS, PARTITIONED, SEQUENTIAL, VSAM-KSDS, VSAM-KSDS-FIXED, VSAM-ESDS, VSAM-ESDS-FIXED, VSAM-RRDS or VSAM-RRDS-FIXED, the format of mainframe-parameters is as follows:

  dataset
  EXTENSION=extension
  

  where the parameters are:

  • dataset The name of the dataset to be monitored.
  • extension The extension of the datset to be monitored. This is optional.
• When dataset-type is ENDEVOR, the format of mainframe-parameters is as follows:

  ENV 'environment' SYS
  'system' SUB 'subsystem'
  STG 'stage' TYPE=type
  CCID=ccid COMMENT=comment
  EXTENSION=extension

  where the parameters are:

  • environment

    The Endevor environment to be monitored.

  • system

    The Endevor system to be monitored.

  • subsystem

    The Endevor subsystem to be monitored.

  • stage

    The Endevor stage to be monitored. Must be 1 or 2.

  • type

    The Endevor type to be monitored.

  • ccid

    Change control ID.

  • comment

    Comment text.

• When dataset-type is LIBRARIAN or PANVALET, the format of mainframe-parameters is as follows:

  dataset
  [TYPE=type]
  EXTENSION=ext

  where the parameters are:

  • dataset

    The fully qualified name of the data set to be monitored.

  • type
    Optional specific member types for your monitor relationship (if your installation has been set up to use valid Panvalet or Librarian types on the mainframe). You can specify a specific type, or use filter characters to be creative about a collection of types to be monitored. You can embed the filter characters with any other characters for pattern matching, similar to the usage of the wildcard characters on the workstation dir command: * any character may follow

    • ? any character in this position
    • + the character in this position must be non-blank
    • - the character in this position must be a blank
    • / the character in this position must be numeric
    • \ the character in this position must be non-numeric
• ext

  The extension of the files to be monitored.