Skip to main content

VSAM: Configuration

Below are the configuration settings to support detection on VSAM files.

  1. Open ‘zip.jcl’ file placed at the following location ‘…/Dataguise/vsam/jcl/’ and update the following:

    1. Edit the file and add the appropriate job card.
      //JOBNAME JOB (ACCOUNT),'NAME',
      //       CLASS=A,MSGCLASS=H,
      //       REGION=0M

    2. Enter the JCLLIB where the modified PKWDGZIP proc resides.
      //PROCLIB JCLLIB ORDER=(USER.PROCLIB)

  2. Remove the asterik (*) and change the SAMPLE(%) to desired value. Similarly, set the threshold size for MAXSZ using K(ilobyte), M(egabyte), or G(igabyte). By default, this parameter is commented out.
    //* SET DTXPARM='UNPACK,SAMPLE(10%),MAXSZ(1M)'

  3. Open ‘listcat.jcl’ file placed at the following location ‘…/Dataguise/vsam/jcl/’ and update the following:

    1. Edit the listcat.jcl file and add the same job card details which are added in zip.jcl.
      //JOBNAME JOB (ACCOUNT),'NAME',
      //       CLASS=A,MSGCLASS=H,
      //       REGION=0M

    2. Enter the same JCLLIB details which were added in the zip.jcl file.
      //PROCLIB JCLLIB ORDER=(USER.PROCLIB)

  4. Copy the *.copybook files in the copybooks folder placed at location ‘…/Dataguise/vsam/copybooks/’. The format of each file must be ASCII UTF-8.

  5. Copy the *.xml files in the xml folder placed at location ‘…/Dataguise/vsam/xml/’. The format of each file must be ASCII UTF-8. There should be one xml file for each copybook.

  6. Open each *.xml file placed at the following location ‘…/Dataguise/vsam/xml/’. Enter the absolute path and the filename of each copybook.text file. This will create xml mapping of copybooks.
    .../Dataguise/vsam/xml/mapping1.xml
    <Mapping>
    <DatasetName>[Insert absolute path to copybook.txt file]</DatasetName>
    <Copybooks>
    <Copybook name="[Insert absolute path to copybook.txt file]">

  7. Open vsam_xml_mapping.xml placed at the following location ‘/Dataguise/vsam/layouts/’. Add the VSAM dataset name, associated xml mapping and filename in this file for every dataset that you want to scan.
    [Format]     VSAM File Names||XML Mapping path and file

  8. Open ‘HDFSAgentConfig.properties’ file placed at the following location ‘…/DgSecure/Agents/LocalFilesAgent/expandedArchive/WEB-INF/classes/’ and update the below mentioned properties:

    1. vsam.mapping.layour.file.path- This file contains the details of the VSAM file and its mapping file. If mapping for VSAM file does not exists, then that file will be skipped.

    2. vsam.file.upload.path – On this location the zip VSAM files will be uploaded by JCL job.

    3. Vsam.zip.jcl.path – This property specifies the absolute path of the JCL file.

    4. Vsam.listcat.jcl.path – This property specifies the absolute path of the listcat jcl file which fetches the files based on the search string.

    5. Vsam.hostname – This property specifies the ZOS hostname.

    6. Vsam.file.unzip.dir – This property specifies the path where the extracted VSAM files are stored. The files are deleted from the location when processing is completed.

    7. Vsam.authorization.token – This property lets you specify the token used for JCL job.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.