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.