Export of libraries from archive (hwm_export_zos_library)

This utility allows exporting of z/OS libraries from ProcMan’s archive into a file. This file can be for example transferred to the z/OS system, a temporary library containing members in the archive can be created from the file and the temporary library can be compared with the ProcMan’s target library to find out, whether there are changes in the target library done outside of ProcMan. The utility is stored in the bin subdirectory of the ProcMan installation. For to start it, change in the directory where ProcMan is installed (with cd command in the command window or by setting the work directory in a scheduler) and execute the command:

Windows:

bin\hwm_export_zos_library.cmd -f <output_file> -c <configuration_id>

Unix:

bin/hwm_export_zos_library.sh -f <output_file> -c <configuration_id>

In the execution command replace the <output_file> with the file name (including an absolute or relative path) of the output file in which the library in the archive shall be exported and the <configuration_id> with a valid configuration id of the required configuration from the configuration file etc/hwm_export_zos_library_config.php. Take care that the configuration id is case sensitive so it has to be tipped exactly like it is specified in the configuration file.

Before the utility can be started the library which shall be exported from the archive has to be described in the configuration file etc/hwm_export_zos_library_config.php of the ProcMan installation. Let us explain the content of the configuration file on an example:

<?php
$hwm_export_zos_library_config = array(
    'library' => 'P390A.PM30.JOBLIB',
    'archive' => 'JCL',
    'system' => 'PMPROD',

    'config' => array(
        'JOBLIB' => array(
        ),
        'SYSIN1' => array(
            'archive' => 'SYSIN',
            'library' => 'P390A.PM30.SYSLIB',
        ),
        'SYSIN2' => array(
            'archive' => 'SYSIN',
            'library' => 'P390A.PM30.SYSLIB2',
        ),
    ),
);
?>

In the parameter library the ProcMan’s target library which shall be exported has to be specified.

In the parameter archive the archive type of the library has to be specified. Currently only one of the values 'JCL', 'SYSIN', or 'PROC' is meaningful for this parameter.

In the parameter system the system id of the exported target library has to be specified. The proper value for this parameter can be found in the 'system_mapping' section of the etc/hos_config2.php file in the value of the 'id' parameter.

In the config section configurations has to be defined. Meaningful is to define at least one configuration. The global parameters defined outside of the config section are used for all configurations unless they are overridden in single configurations. Each configuration has to have an id and a subsection in which the global parameters can be overridden. The id of the configuration is being used in the –c parameter in the execution command of the utility to specify the configuration using which the utility shall be executed.

If the utility finds some members in the archive it writes an entry for each member to the output file. Each member entry starts with a line like this:

./ ADD NAME=<member_name>

This line is followed by the content of the member. The output file can be transferred to the z/OS system in text mode (with code page conversion) for example using ftp. On the z/OS system a JCL for extracting the members from the transferred file in a temporary library and for comparing the temporary library with the reference library looks like this:

//PMJCLCMP JOB  (DEFAULT),
//        'PROCMAN     ',NOTIFY=&SYSUID,REGION=0M
//**********************************************************************
//* CREATE JOBLIB, BASED ON ARCHIVE UNLOAD AND COMPARE WITH TARGET LIB
//**********************************************************************
//IDCAMS   EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
 DEL P390A.PM30.DATA.OUT.J001
 SET MAXCC = 0
//************************************************************
//* LOAD MEMBERS INTO JCL-PDS
//************************************************************
//LOADMEM  EXEC PGM=IEBUPDTE,PARM='NEW',COND=(4,LT)
//SYSPRINT DD SYSOUT=*
//SYSIN    DD DSN=P390A.PM30.DATA.OUT,
//            DISP=SHR
//SYSUT2   DD DSN=P390A.PM30.DATA.OUT.J001,
//            DISP=(,CATLG),
//            SPACE=(TRK,(500,500,50)),
//            DCB=(DSORG=PO,RECFM=FB,LRECL=80)
//************************************************************
//* COMPARE ARCHIVE-LIB WITH ZOS TARGET-LIB
//************************************************************
//SUPERC  EXEC PGM=ISRSUPC,
//            PARM=(DELTAL,LINECMP,
//            ' SEQ',
//            '')
//NEWDD  DD DSN=P390A.PM30.JOBLIB,
//          DISP=SHR
//OLDDD  DD DSN=P390A.PM30.DATA.OUT.J001,
//          DISP=SHR
//OUTDD  DD SYSOUT=*

In the example above: P390A.PM30.DATA.OUT contains the transferred file generated by the utility, P390A.PM30.DATA.OUT.J001 is the temporary library and P390A.PM30.JOBLIB is the reference library.