MONITOR

Syntax

MONITOR[PVCS]
[BINARY]
direction [PREFIX filter]
dataset-type
drive:\directory\*.ext
AGAINST mainframe-parameters 

Specifies which workstation directories (when MONITOR is used) or PVCS archives (when MONITORPVCS is used) are to be monitored against which mainframe data sets or source code control systems. Any number of these statements can be placed in the configuration file as desired.

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.