//GIN19SMP JOB JOB00301 //* //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Updated: October 23, 2020 * //* _________________________________________________________________ * //* * //* This job loads a set of sample jobs for using IBM Installation * //* Manager (5655-IMZ) on zOS. * //* * //* These jobs can also be found in the SGINJCL library when IBM * //* Installation Manager is installed with SMP/E; they are provided * //* here for customers who choose to install without SMP/E. * //* * //* These jobs are intended for use with Installation Manager 1.9.0 * //* or above. * //* * //********************************************************************* //IEBUPDTE EXEC PGM=IEBUPDTE,PARM=NEW //SYSPRINT DD SYSOUT=* //SYSUT2 DD DISP=(NEW,CATLG),DSN=GIN.IM190.SAMPJOBS, // SPACE=(TRK,(15,5,20)), // RECFM=FB,LRECL=80,BLKSIZE=0 //SYSIN DD DATA,DLM='$$' ./ ADD NAME=GIN$INDX Index of IBM Installation Manager sample jobs "Portable" refers to a product installation in which the Installation Manager metata ("appdata") and cache are stored together with one or more products in a single filesystem. GIN1* (SMP/E jobs for IBM Installation Manager) GIN2ADMN Create an Installation Manager user ID and group GIN2CFS Create a filesystem for an Installation Manager GIN2REPO Create a filesystem for a local repository GIN2INST Create an Installation Manager GIN2UNIN Delete an Installation Manager GIN3CRED Create credentials for the web-based repository GIN3CFS Create a filesystem for a new product / package group GIN3CMD Issue an Installation Manager command GIN3INS Install a product from the web-based repository GIN3INSL Install a product from a local repository GIN3IFIX Install an interim fix from the web-based repository GIN3IFXL Install an interim fix from a local repository GIN3UNIN Uninstall a product GIN3LSTA List available products in the web-based repository GIN3LSTL List available products in a local repository GIN3LSTF List available interim fixes GIN3LSTI List installed products The following sample jobs are for use with portable installs. GIN3CFSP Create a filesystem for a new product (portable) GIN3CMDP Issue an Installation Manager command (portable) GIN3INSP Install a product from the web-based repository (port) GIN3INSQ Install a product from a local repository (portable) GIN3IFXP Install an interim fix (web-based repository, portable) GIN3IFXQ Install an interim fix (local, portable) GIN3UNIP Uninstall a product (portable) GIN3LSTB List available products (web-based repository, portable) GIN3LSTM List available products (local repository, portable) GIN3LSTG List available interim fixes (portable install) GIN3LSTJ List installed products (portable install) ./ ADD NAME=GIN2ADMN //GIN2ADMN JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2011 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job creates a SAF group and user ID for an Installation * //* Manager. * //* * //* The following SAF profiles must already exist before this job * //* is run: * //* * //* Class: FACILITY Profiles: BPX.FILEATTR.APF * //* BPX.FILEATTR.PROGCTL * //* BPX.FILEATTR.SHARELIB * //* * //* Class: UNIXPRIV Profiles: SUPERUSER.FILESYS.CHOWN * //* SUPERUSER.FILESYS.CHANGEPERMS * //* * //* See the z/OS Unix System Services Planning manual for more * //* information about these profiles, and how to set them up. * //* * //* This job must run under a user ID with RACF Special authority. * //* * //* Copy this job to a separate data set and make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements * //* 2) Change 'gid' to an unused SAF numeric group ID. * //* 3) Change 'uid' to an unused SAF numeric user ID. * //* 4) Change '/u/imadmin' to an appropriate home directory path * //* for the Installation Manager user ID. This directory must * //* be read/write. Also, due to Eclipse restrictions, the home * //* directory path must not include certain special characters, * //* such as the pound sign (#). See the Installation Manager * //* documentation for a complete list of restricted characters. * //* * //* Then submit the job. Examine the output for any error messages. * //* * //* When the job has run successfully, issue the following RACF * //* command to set the password for the Installation Manager * //* user ID: * //* * //* ALTUSER IMADMIN PASSWORD(password) NOEXPIRE * //* * //* Create the home directory if it does not already exist, and * //* make sure that it is owned by the Installation Manager user ID * //* and group. This can be done with the Unix System Services * //* chown command: * //* * //* chown IMADMIN:IMGROUP /u/imadmin * //* * //* To use different user and group ID names, or to create separate * //* user IDs and groups for additional Installation Managers, change * //* 'IMADMIN' and 'IMGROUP' to the desired ID and group names. * //* * //* Several Installation Manager user IDs can share the same default * //* group, by setting the default group (DFLTGRP) value for the * //* additional user IDs to the shared Installation Manager group. * //* * //* To allow existing user IDs to invoke the Installation Manager, * //* connect them to the group ID for the Installation Manager: * //* * //* CONNECT another_userid GROUP(IMGROUP) * //* * //* These user IDs must be given the same permissions granted below * //* to the default Installation Manager user ID. * //* * //* Expected return code and messages: 0, no messages * //* * //********************************************************************* //RACF EXEC PGM=IKJEFT01,DYNAMNBR=20,REGION=0M //SYSTSPRT DD SYSOUT=* //SYSTSIN DD * ADDGROUP IMGROUP OMVS(GID(gid)) ADDUSER IMADMIN DFLTGRP(IMGROUP) OMVS(UID(uid) HOME('/u/imadmin') + PROGRAM('/bin/sh')) NOPASSWORD PERMIT BPX.FILEATTR.APF CL(FACILITY) ID(IMADMIN) ACCESS(READ) PERMIT BPX.FILEATTR.PROGCTL CL(FACILITY) ID(IMADMIN) ACCESS(READ) PERMIT BPX.FILEATTR.SHARELIB CL(FACILITY) ID(IMADMIN) ACCESS(READ) PERMIT SUPERUSER.FILESYS.CHOWN CL(UNIXPRIV) + ID(IMADMIN) ACCESS(READ) PERMIT SUPERUSER.FILESYS.CHANGEPERMS CL(UNIXPRIV) + ID(IMADMIN) ACCESS(READ) SETR RACLIST(FACILITY) REFRESH SETR RACLIST(UNIXPRIV) REFRESH /* ./ ADD NAME=GIN2CFS //GIN2CFS JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job allocates and mounts a new filesystem for an * //* Installation Manager. * //* * //* This filesystem should be owned by an Installation Manager user * //* ID and group such as those created with the GIN2ADMN job. * //* * //* This job creates a single filesystem large enough to hold all * //* binaries and data for a single Installation Manager. The default * //* mountpoint for the filesystem is /global/instmgr. In a sysplex * //* environment, the filesystem should be made available across the * //* sysplex. * //* * //* If you wish to mount your Installation Manager filesystem at a * //* different location, change '/global/instmgr' to your desired * //* value both here and in other Installation Manager sample jobs. * //* * //* This job must be run under a userid with UID=0, or which has * //* READ access to the FACILITY profile BPX.SUPERUSER. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager install kit, if it is mounted at a * //* different location. * //* * //* 3) Change 'prefix' to the data set name prefix to be used for * //* the filesystem associated with this Installation Manager. * //* * //* 4) To create an HFS filesystem instead of a zFS filesystem, * //* change "-type ZFS" to "-type HFS". * //* * //* 5) Set the -volume, -storclas, -dataclas, and -mgmtclas to the * //* appropriate volume and SMS storage, data, and management * //* classes for the new filesystem. Delete any allocation * //* parameters which are not needed on your system. * //* * //* 6) Change IMADMIN and IMGROUP to the SAF user ID and group that * //* will "own" this Installation Manager. These IDs are created * //* by sample job GIN2ADMN. * //* * //* The mountpoint directory, and any required directories above it, * //* will be created. Initial permissions for these directories are * //* set to 775. To alter this initial setting, specify -perm on * //* the zCreateFileSystem.sh call, followed by the desired initial * //* permissions. * //* * //********************************************************************* //* //**************************************************************** //* The following step allocates a filesystem for an * //* Installation Manager. * //**************************************************************** //CREATE EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/zCreateFileSystem.sh + -name prefix.GLOBAL.INSTMGR + -type ZFS + -volume hhhhhh + -storclas ssssssss + -dataclas dddddddd + -mgmtclas mmmmmmmm + -cylinders 2750 250 + -mountpoint /global/instmgr + -owner IMADMIN + -group IMGROUP /* ./ ADD NAME=GIN2INST //GIN2INST JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job creates an Installation Manager. * //* * //* Before running this job, create a SAF group and user ID for the * //* Installation Manager instance (sample job GIN2ADMN), and create * //* a filesystem for the Installation Manager binaries and run-time * //* data (sample job GIN2CFS). * //* * //* This job must be run under the user ID that will own the * //* Installation Manager. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. * //* * //* If a group-mode Installation Manager is being used, then * //* this job must also run under the Unix System Services group * //* associated with the Installation Manager. If necessary, you * //* can specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager install kit, if it is mounted at a * //* different location. * //* * //* 3) The install command provided in the sample below, groupinstc, * //* creates an Installation Manager in group mode. The resulting * //* Installation Manager can be invoked by any user ID that is * //* connected to the default group of the user ID that created * //* the nstallation Manager. (All user IDs that invoke the * //* Installation Manager must also have the privileges granted in * //* sample job GIN2ADMN.) * //* * //* To create an admin-mode Installation Manager, change * //* 'groupinstc' to 'installc'. The user ID that runs this job * //* must be a superuser (uid=0< and only a superuser ID can * //* invoke the resulting Installation Manager. * //* * //* To create a user-mode Installation Manager, change 'installc' * //* to 'userinstc'. The user ID that runs this job does not have * //* to be a superuser, and only this user ID (or a superuser) * //* can invoke the resulting Installation Manager. * //* * //* 4) Change '/global/instmgr/bin' to the path for the Installation * //* Manager binaries, if you have chosen a different location. * //* * //* 5) Change '/global/instmgr/appdata' to the path for the * //* Installation Manager run-time data (appdata), if you have * //* chosen a different location. * //* * //* Submit the job, and examine the output to make sure that the * //* creation of the Installation Manager instance was successful. * //* * //* Logs for the Installation Manager creation can be found in the * //* logs subdirectory of the Installation Manager run-time data: * //* * //* /global/instmgr/appdata/logs * //* * //* If the installation fails, correct the problem that caused the * //* failure, and clear the Installation Manager binaries and appdata * //* directories before re-running this job: * //* * //* rm -R /global/instmgr/bin * //* rm -R /global/instmgr/appdata * //* * //********************************************************************* //* //***************************************************************** //* The following step creates an Installation Manager. * //***************************************************************** //BUILDIM EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/groupinstc + -installationDirectory /global/instmgr/bin + -dataLocation /global/instmgr/appdata + -acceptLicense /* ./ ADD NAME=GIN2REPO //GIN2REPO JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job allocates and mounts a new filesystem for a local * //* Installation Manager repository. This filesystem can hold a * //* single repository created with IBM Packaging Utility, or a * //* collection of compressed product and service repositories. * //* * //* Ensure you execute this job from a userid that is UID=0 * //* or is permitted to the 'BPX.SUPERUSER' facility class. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager install kit, if it is mounted at a * //* different location. * //* * //* 3) Change 'prefix.GLOBAL.INSTMGR.REPO' to the data set name to * //* be used for the repository filesystem. * //* * //* 4) To create an HFS filesystem instead of a zFS filesystem, * //* change "-type ZFS" to "-type HFS". * //* * //* 5) Set the -volume, -storclas, -dataclas, and -mgmtclas to the * //* appropriate volume and SMS storage, data, and management * //* classes for the new filesystem. Delete any allocation * //* parameters which are not needed on your system. * //* * //* 6) Change the allocation for the repository filesystem to the * //* total size of the repositor(ies) it is to contain. * //* * //* You can specify the allocation in either cylinders: * //* * //* -cylinders 2200 220 * //* * //* or megabytes: * //* * //* -megabytes 1800 180 * //* * //* Do not specify both. The first numeric value is the primary * //* allocation; the second is the secondary allocation. * //* * //* The default allocation is sufficient to hold the repositories * //* for a reasonably large product such as WebSphere Application * //* Server for z/OS. See your product documentation for estimated * //* repositories sizes. A single filesystem can contain product * //* and service repositories for several products. * //* * //* 7) Change '/global/instmgr/repo' to the mountpoint you wish to * //* use for the repository. * //* * //* 8) Change IMADMIN and IMGROUP to your Installation Manager user * //* ID and group. * //* * //* The mountpoint directory, and any required directories above it, * //* will be created. Initial permissions for these directories are * //* set to 775. To alter this initial setting, specify -perm on * //* the zCreateFileSystem.sh call, followed by the desired initial * //* permissions. * //* * //********************************************************************* //* //**************************************************************** //* The following step allocates a new filesystem for a local * //* Installation Manager repository. * //**************************************************************** //CREATE EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/zCreateFileSystem.sh + -name prefix.GLOBAL.INSTMGR.REPO + -type ZFS + -volume hhhhhh + -storclas ssssssss + -dataclas dddddddd + -mgmtclas mmmmmmmm + -cylinders 3000 200 + -mountpoint /global/instmgr/repo + -owner IMADMIN + -group IMGROUP /* ./ ADD NAME=GIN2UNIN //GIN2UNIN JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job deletes an Installation Manager. * //* * //* This job must be run under the user ID that owns the * //* Installation Manager. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under the Installation Manager * //* user ID. * //* * //* 2) Change '/global/instmgr/appdata' to the path for the * //* Installation Manager's run-time data (appdata), if you have * //* chosen a different location. * //* * //* Submit the job, and examine the output to make sure that the * //* deletion of the Installation Manager was successful. * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes the uninstallc script to * //* delete an Installation Manager. * //**************************************************************** //BUILDIM EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/appdata/uninstall/uninstallc /* ./ ADD NAME=GIN3CFS //GIN3CFS JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job allocates and mounts a new filesystem for a product * //* install with IBM Installation Manager. * //* * //* Products are installed into package groups, each of which is * //* associated with a particular installation director. This job * //* allocates and mounts the target directory for a new package * //* group. * //* * //* This job does not actually create a package group; that is done * //* automatically during product installation if a new package group * //* name is specified. * //* * //* Ensure you execute this job from a userid that is UID=0 * //* or is permitted to the 'BPX.SUPERUSER' facility class. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* 1) Add the job parameters to meet your system requirements * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager install kit, if it is mounted at a * //* different location. * //* * //* 3) Change 'target.dsn' to the data set name to be used for the * //* the target filesystem associated with this package group. * //* * //* 4) To create an HFS filesystem instead of a zFS filesystem, * //* change "-type ZFS" to "-type HFS". * //* * //* 5) Set the -volume, -storclas, -dataclas, and -mgmtclas to the * //* appropriate volume and SMS storage, data, and management * //* classes for the new filesystem. Delete any allocation * //* parameters which are not needed on your system. * //* * //* 6) Change the allocations for the target filesystem to match * //* the total requirements for the product(s) to be installed * //* in this package group. * //* * //* You can specify the allocation in either cylinders: * //* * //* -cylinders 2200 220 * //* * //* or megabytes: * //* * //* -megabytes 1800 180 * //* * //* Do not specify both. The first numeric value is the primary * //* allocation; the second is the secondary allocation. * //* * //* 7) Change '/global/instmgr/products/product/level' to the * //* mountpoint to be used for the target filesystem. This * //* mountpoint is only used when the product is being installed * //* or serviced with IBM Installation Manager. The path to this * //* mountpoint should not contain symbolic links or system * //* variables. * //* * //* 8) Change IMADMIN and IMGROUP to the SAF user ID and group that * //* will "own" this package group's files. This will usually be * //* the same user ID and group that own the Installation Manager * //* instance to which the package group belongs. * //* * //* The mountpoint directory, and any required directories above it, * //* will be created. Initial permissions for these directories are * //* set to 775. To alter this initial setting, specify -perm on * //* the zCreateFileSystem.sh call, followed by the desired initial * //* permissions. * //* * //********************************************************************* //* //**************************************************************** //* The following step allocates a new filesystem for the * //* package group target directory. * //**************************************************************** //CREATE EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/zCreateFileSystem.sh + -name target.dsn + -type ZFS + -volume hhhhhh + -storclas ssssssss + -dataclas dddddddd + -mgmtclas mmmmmmmm + -cylinders 2200 220 + -mountpoint /global/instmgr/products/product/level + -owner IMADMIN + -group IMGROUP /* ./ ADD NAME=GIN3CFSP //GIN3CFSP JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job allocates and mounts a new filesystem for a product * //* install with IBM Installation Manager. * //* * //* Ensure you execute this job from a userid that is UID=0 * //* or is permitted to the 'BPX.SUPERUSER' facility class. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Change 'target.dsn' to the data set name to be used for the * //* the target filesystem associated with this portable install. * //* * //* 4) To create an HFS filesystem instead of a zFS filesystem, * //* change "-type ZFS" to "-type HFS". * //* * //* 5) Set the -volume, -storclas, -dataclas, and -mgmtclas to the * //* appropriate volume and SMS storage, data, and management * //* classes for the new filesystem. Delete any allocation * //* parameters which are not needed on your system. * //* * //* 6) Change the allocations for the target filesystem to match * //* the total requirements for the product(s) to be installed * //* in this package group. * //* * //* You can specify the allocation in either cylinders: * //* * //* -cylinders 2200 220 * //* * //* or megabytes: * //* * //* -megabytes 1800 180 * //* * //* Do not specify both. The first numeric value is the primary * //* allocation; the second is the secondary allocation. * //* * //* 6) Change $INSTALL to the portable install name, the directory * //* in /global/instmgr which will contain the installed * //* products(s) and their Installation Manager metadata and logs. * //* You may want to include some form of the $INSTALL value in * //* the filesystem dataset name. The filesystem must be mounted * //* at this location whenever the product(s) are serviced with * //* Installation Manager. * //* * //* 7) Change IMADMIN and IMGROUP to the SAF user ID and group that * //* will "own" this package group's files. This will usually be * //* the same user ID and group that own the Installation Manager * //* instance to which the package group belongs. * //* * //* The mountpoint directory, and any required directories above it, * //* will be created. Initial permissions for these directories are * //* set to 775. To alter this initial setting, specify -perm on * //* the zCreateFileSystem.sh call, followed by the desired initial * //* permissions. * //* * //********************************************************************* //* //**************************************************************** //* The following step allocates a new filesystem for the * //* package group target directory. * //**************************************************************** //CREATE EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/zCreateFileSystem.sh + -name target.dsn + -type ZFS + -volume hhhhhh + -storclas ssssssss + -dataclas dddddddd + -mgmtclas mmmmmmmm + -cylinders 100 100 + -mountpoint + /global/instmgr/$INSTALL + -owner IMADMIN + -group IMGROUP /* ./ ADD NAME=GIN3CMD //GIN3CMD JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job issues an IBM Installation Manager command using the * //* command line tool. * //* * //* The user ID used to run this job must have the authority to * //* invoke the Installation Manager. * //* * //* Group-mode Installation Manager (created with groupinstc) * //* Invoking user ID must be connected to the default group of * //* the user ID that created the Installation Manager, and * //* must also have access to the SAF profiles outllined in * //* sample job GIN2ADMN. * //* * //* Admin-mode Installation Manager (created with installc) * //* Invoking user ID must be a superuser, and have access to * //* the SAF profiles outlined in sample job GIN2ADMN. * //* * //* User-mode Installation Manager (created with userinstc) * //* Invoking user ID must be the user ID that created the * //* Installation Manager, and have access to the SAF profiles * //* outlined in sample job GIN2ADMN. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. * //* * //* If a group-mode Installation Manager is being used, then * //* this job must also run under the Unix System Services group * //* associated with the Installation Manager. If necessary, you * //* can specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* 2) Change '/global/instmgr/bin' to the location of the binaries * //* directory for the Installation Manager to be used. * //* * //* 3) Change 'command' to the Installation Manager command to be * //* executed. If the command will not fit on one line (do not * //* go beyond column 72), you can use a plus sign (+) as a * //* continuation character, for as many lines as necessary: * //* * //* command -options .................. + * //* (second line of options) ........ + * //* (last line of options) * //* * //* The following commands can be issued; see the IBM Installation * //* Manager documentation for complete command specifications and * //* usage. * //* * //* install (see sample job GIN3INST) * //* * //* uninstall (see sample job GIN3UNIN) * //* * //* update update installed packages * //* * //* -help display Installation Manager commands * //* * //* -version display Installation Manager version * //* * //* listInstalledPackages * //* * //* listAvailablePackages * //* * //* listAvailableFixes * //* * //* You may wish to copy this sample job into a library, creating a * //* separate job for each command you normally use. * //* * //* Submit the job, and examine the output to make sure that the * //* command was successful. * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes the IBM Installation Manager * //* command line tool. * //**************************************************************** //INSTALL EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + command /* ./ ADD NAME=GIN3CMDP //GIN3CMDP JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job issues an IBM Installation Manager command using the * //* command line tool. * //* * //* The user ID used to run this job must have the authority to * //* invoke the Installation Manager. * //* * //* Group-mode Installation Manager (created with groupinstc) * //* Invoking user ID must be connected to the default group of * //* the user ID that created the Installation Manager, and * //* must also have access to the SAF profiles outllined in * //* sample job GIN2ADMN. * //* * //* Admin-mode Installation Manager (created with installc) * //* Invoking user ID must be a superuser, and have access to * //* the SAF profiles outlined in sample job GIN2ADMN. * //* * //* User-mode Installation Manager (created with userinstc) * //* Invoking user ID must be the user ID that created the * //* Installation Manager, and have access to the SAF profiles * //* outlined in sample job GIN2ADMN. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. * //* * //* If a group-mode Installation Manager is being used, then * //* this job must also run under the Unix System Services group * //* associated with the Installation Manager. If necessary, you * //* can specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Change 'command' to the Installation Manager command to be * //* executed. If the command will not fit on one line (do not * //* go beyond column 72), you can use a plus sign (+) as a * //* continuation character, for as many lines as necessary: * //* * //* command -options .................. + * //* (second line of options) ........ + * //* (last line of options) * //* * //* The following commands can be issued; see the IBM Installation * //* Manager documentation for complete command specifications and * //* usage. * //* * //* install (see sample job GIN3INST) * //* * //* uninstall (see sample job GIN3UNIN) * //* * //* update update installed packages * //* * //* -help display Installation Manager commands * //* * //* -version display Installation Manager version * //* * //* listInstalledPackages * //* * //* listAvailablePackages * //* * //* listAvailableFixes * //* * //* You may wish to copy this sample job into a library, creating a * //* separate job for each command you normally use. * //* * //* 2) If the command requires access to the Installation Manager * //* metata (-dataLocation) for a particular portanle install, * //* change $INSTALL to the portable install name, the directory * //* in /global/instmgr which containers the installed product(s) * //* and its Installation Manager metata and logs. * //* * //* Otherwise, remove the -dataLocation parameter (remember to + //* also remove the continuation character (+) on the preceding * //* line. * //* * //* Submit the job, and examine the output to make sure that the * //* command was successful. * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes the IBM Installation Manager * //* command line tool. * //**************************************************************** //INSTALL EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + command + -dataLocation + /global/instmgr/$INSTALL/.im/appdata + -accessRights group /* ./ ADD NAME=GIN3CRED //GIN3CRED JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job creates a credentials file to access Web-based * //* product and service repositories for IBM software products. * //* It requires a minimum IBM Installation Manager level of 1.8.5. * //* * //* The credentials file is placed in the home directory ($HOME) of * //* the user ID that runs the GIN3CRED job. The GIN3CRED job should * //* be run under each user ID that will be used to access web-based * //* based repositories with IBM Installation Manager. Alternatively, * //* a single set of credentials files (including the master password * //* file) can be created and kept in a common location. * //* * //* Before running this job, create an Installation Manager user ID * //* and group (Installation Manager sample job GIN2ADMN), * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See InstallationManager sample job * //* GIN2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager install kit, if it is mounted at a * //* different location. * //* * //* 3) If you do not already have an IBM user ID, obtain one by * //* pointing a Web browser to: * //* * //* http://www.ibm.com/account/profile * //* * //* In the steps below, change 'IBM_userid' to your IBM user ID, * //* and change 'IBM_password' to the corresponding password. * //* * //* Associating this user ID with an entitled IBM customer number * //* may also allow you to install entire products from the online * //* repository. For more information about this process, see: * //* * //* http://www.ibm.com/support/docview.wss?uid=swg21659636 * //* * //* 4) Create a Unix System Sevices file to be used as an encryption * //* key, and place one or more lines of text in the file. * //* We recommend you create it in the same directory as the * //* credentials file (by default, the user's home directory). * //* Onnce the master password file is created, change the file * //* permissions to allow access only by the file owner: * //* * //* chmod 700 $HOME/im.mpw * //* * //* If using shared credentials files with an Installation * //* Manager in group mode, set the file permissions to allow the * //* owning user and group to read the file: * //* * //* chmod 750 /global/instmgr/im.mpw * //* * //* 5) If you need to use a proxy server to access the Internet, * //* change proxy.hostname and proxy_port to the host name and * //* port for the proxy server, and change proxy_username and * //* proxy_password to the user name and password for proxy * //* server authentication. The proxy server credentials will * //* be saved in the same file with your repository credentials. * //* * //* If you do NOT need to use a proxy server to access the * //* Internet, delete the four lines beginning with '-proxy'. * //* * //* 6) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to make sure that the * //* credentials were accepted, and saved in the credentials file. * //* * //********************************************************************* //* //**************************************************************** //* The following step creates a credentials file for use with * //* IBM Installation Manager and the Web-based product and * //* service repository. * //**************************************************************** //CRED EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imutilsc saveCredential + -userName IBM_userid + -userPassword IBM_password + -proxyHost proxy.hostname + -proxyPort proxy_port + -proxyUserName proxy_username + -proxyUserPassword proxy_password + -url http://www.ibm.com/software/repositorymanager/entitled + -secureStorageFile $HOME/im.ssf + -masterPasswordFile $HOME/im.mpw /* ./ ADD NAME=GIN3IFIX //GIN3IFIX JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job installs an interim fix with IBM Installation Manager * //* from the web-based service repository. * //* * //* Before running this job: * //* * //* 1. Edit and submit Installation Manager sample job GIN3CRED * //* to create a credentials file containing your IBM user ID * //* and password (along with proxy server credentials if you * //* use a proxy server to access the internet from your z/OS * //* system). * //* * //* 2. Identify the name of the interim fix to be installed, and * //* the installation directory of the product to which it is * //* to be installed. Mount the product filesystem read/write * //* at this location. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See Installation Manager sample job * //* GIN2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/global/instmgr/bin' to the path for the Installation * //* Manager binaries, if you have chosen a different location. * //* * //* 3) Change 'ifix_name' to the full name of the interim fix to be * //* installed (for example, 9.0.0.0-WS-WAS-IFPM88937). * //* * //* 4) Change '/global/instmgr/products/product/level' to the * //* installation directory of the product onto which the interim * //* fix is being installed. Make sure the product filesystem * //* is mounted (read/write) at this location. * //* * //* 5) Change 'package.name' to the name of the package onto which * //* the interim fix is being installed (for example, * //* com.ibm.websphere.zOS.v90). This will allow the appropriate * //* repository to be accessed. * //* * //* 6) If you need to use a proxy server to access the Internet, * //* change 'proxy.hostname' and 'proxy_port' to the host name * //* and port for your proxy server. Your Installation Manager * //* credentials file must also contain any required credentials * //* to access the proxy server; see sample job GIN3CRED. * //* * //* If you do NOT need to use a proxy server to access the * //* Internet, delete the six lines beginning with '-preferences'. * //* * //* 7) Change '$HOME/im.ssf' to the path and file name of the * //* credentials file you created with GIN3CRED. * //* * //* Change '$HOME/im.mpw' to the path and file name of your * //* master password file. * //* * //* Both files must be readable by the user ID under which this * //* job is run. * //* * //* 8) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to make sure that the * //* product installation was successful. * //* * //* Logs for product installation can be found in the logs * //* subdirectory of the Installation Manager run-time data; e.g. * //* * //* /global/instmgr/appdata/logs * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes IBM Installation Manager to * //* install an interim fix. * //**************************************************************** //INSTFIX EXEC PGM=IKJEFT01,REGION=0M,MEMLIMIT=NOLIMIT //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + install ifix_name + -installationDirectory + /global/instmgr/products/product/level + -repositories http://www.ibm.com/software/repositorymanager/+ package.name + -preferences + com.ibm.cic.common.core.preferences.http.proxyEnabled=True,+ com.ibm.cic.common.core.preferences.http.proxyHost=+ proxy.hostname,+ com.ibm.cic.common.core.preferences.http.proxyPort=+ proxy_port + -secureStorageFile $HOME/im.ssf + -masterPasswordFile $HOME/im.mpw /* ./ ADD NAME=GIN3IFXL //GIN3IFXL JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job installs an interim fix with IBM Installation Manager * //* from a local repository (generally a downloaded .zip file). * //* * //* Before running this job: * //* * //* 1. Identify the name and location of the interim fix to be * //* installed. Generally this will be a .zip file obtained * //* from Fix Central or IBM Support. Make sure the file can * //* be read by the Installation Manager user ID. * //* * //* 2. Identify the installation directory of the product to which * //* this fix is to be applied. Mount the product filesystem * //* (read/write) at this location. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See Installation Manager sample job * //* GIN2ADMN for a description of the required privileges.) * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* 2) Change '/global/instmgr/bin' to the path for the Installation * //* Manager binaries, if you have chosen a different location, * //* * //* 3) Change 'ifix_name' to the full name of the interim fix to be * //* installed (for example, 9.0.0.0-WS-WAS-IFPM88937). * //* * //* 4) Change '/global/instmgr/products/product/level' to the * //* installation directory of the product onto which the interim * //* fix is being installed. Make sure the product filesystem * //* is mounted (read/write) at this location. * //* * //* 5) Change '/global/instmgr/repo/ifix_name.zip' to the path and * //* filename of the file containing the interim file. The * //* filename will usually the same as the ifix identifier, with * //* a '.zip' extension. If the interim fix has been uncompressed, * //* specify the directory containing the uncompressed ifix, * //* * //* 6) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to make sure that the * //* product installation was successful. * //* * //* Logs for product installation can be found in the logs * //* subdirectory of the Installation Manager run-time data; e.g. * //* * //* /global/instmgr/appdata/logs * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes IBM Installation Manager to * //* install an interim fix. * //**************************************************************** //INSTFIX EXEC PGM=IKJEFT01,REGION=0M,MEMLIMIT=NOLIMIT //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + install ifix_name + -installationDirectory + /global/instmgr/products/product/level + -repositories + /global/instmgr/repo/ifix_name.zip /* ./ ADD NAME=GIN3IFXP //GIN3IFXP JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job installs an interim fix with IBM Installation Manager * //* from the web-based service repository. * //* * //* Before running this job: * //* * //* 1. Edit and submit Installation Manager sample job GIN3CRED * //* to create a credentials file containing your IBM user ID * //* and password (along with proxy server credentials if you * //* use a proxy server to access the internet from your z/OS * //* system). * //* * //* 2. Identify the name of the interim fix to be installed, and * //* the installation directory of the product to which it is * //* to be installed. Mount the product filesystem read/write * //* at this location. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See Installation Manager sample job * //* GIN2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Change $IFIX_NAME to the full name of the interim fix to be * //* installed (for example, 9.0.0.0-WS-WAS-IFPM88937). * //* * //* 4) Change $INSTALL to the portable install name, the directory * //* in /global/instmgr which contains the installed product(s) * //* and their Installation Manager metadata and logs. * //* * //* 5) Change $PRODUCT to the product identifier which identifies * //* the spcific product in the portable install to which the * //* interim fix is to be applied. * //* * //* 6) Change $PACKAGE_NAME to the name of the package onto which * //* the interim fix is being installed (for example, * //* com.ibm.websphere.zOS.v85). This will allow the appropriate * //* repository to be accessed. * //* * //* 7) If you need to use a proxy server to access the Internet, * //* change 'proxy.hostname' and 'proxy_port' to the host name * //* and port for your proxy server. Your Installation Manager * //* credentials file must also contain any required credentials * //* to access the proxy server; see sample job GIN3CRED. * //* * //* If you do NOT need to use a proxy server to access the * //* Internet, delete the six lines beginning with '-preferences'. * //* * //* 7) Change '$HOME/im.ssf' to the path and file name of the * //* credentials file you created with GIN3CRED. * //* * //* Change '$HOME/im.mpw' to the path and file name of your * //* master password file. * //* * //* Both files must be readable by the user ID under which this * //* job is run. * //* * //* 8) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to make sure that the * //* product installation was successful. * //* * //* Logs for product installation can be found in the logs * //* subdirectory of the Installation Manager run-time data; e.g. * //* * //* /global/instmgr/$INSTALL/.im/appdata/logs * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes IBM Installation Manager to * //* install an interim fix. * //**************************************************************** //INSTFIX EXEC PGM=IKJEFT01,REGION=0M,MEMLIMIT=NOLIMIT //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + install $IFIX_NAME + -dataLocation + /global/instmgr/$INSTALL/.im/appdata + -installationDirectory + /global/instmgr/$INSTALL/$PRODUCT + -repositories http://www.ibm.com/software/repositorymanager/+ $PACKAGE_NAME + -preferences + com.ibm.cic.common.core.preferences.http.proxyEnabled=True,+ com.ibm.cic.common.core.preferences.http.proxyHost=+ proxy.hostname,+ com.ibm.cic.common.core.preferences.http.proxyPort=+ proxy_port + -secureStorageFile $HOME/im.ssf + -masterPasswordFile $HOME/im.mpw + -accessRights group /* ./ ADD NAME=GIN3IFXQ //GIN3IFXQ JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job installs an interim fix with IBM Installation Manager * //* from a local repository (generally a downloaded .zip file). * //* * //* Before running this job: * //* * //* 1. Identify the name and location of the interim fix to be * //* installed. Generally this will be a .zip file obtained * //* from Fix Central or IBM Support. Copy the file into the * //* /global/instmgr/repo directory and make sure it is * //* readable by the user ID that will apply the fix. * //* * //* 2. Identify the installation directory of the product to which * //* this fix is to be applied. Mount the product filesystem * //* (read/write) at this location. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See Installation Manager sample job * //* GIN2ADMN for a description of the required privileges.) * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Change $IFIX_NAME to the full name of the interim fix to be * //* installed (for example, 9.0.0.0-WS-WAS-IFPM88937). * //* * //* 4) Change $INSTALL to the portable install name, the directory * //* in /global/instmgr which contains the installed product(s) * //* and their Installation Manager metadata and logs. * //* * //* 5) Change $PRODUCT to the product identifier which identifies * //* the spcific product in the portable install to which the * //* interim fix is to be applied. * //* * //* 6) Change $IFIX_FILENAME.zip to the filename of the file which * //* contains the interim fix. The filename will usually be the * //* same as the interim file, with a '.zip' extension. If the * //* file is not in /global/instmgr/repo, change the path as well. * //* If the interim fix has been uncompressed, specify the * //* directory into which it has been uncompressed. * //* * //* 7) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to make sure that the * //* product installation was successful. * //* * //* Logs for product installation can be found in the logs * //* subdirectory of the Installation Manager run-time data; e.g. * //* * //* /global/instmgr/$INSTALL/.im/appdata/logs * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes IBM Installation Manager to * //* install an interim fix. * //**************************************************************** //INSTFIX EXEC PGM=IKJEFT01,REGION=0M,MEMLIMIT=NOLIMIT //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + install $IFIX_NAME + -dataLocation + /global/instmgr/$INSTALL/.im/appdata + -installationDirectory + /global/instmgr/$INSTALL/$PRODUCT + -repositories + /global/instmgr/repo/$IFIX_FILENAME.zip + -accessRights group /* ./ ADD NAME=GIN3INS //GIN3INS JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job installs a product from the web-based product * //* repository. * //* * //* Before running this job: * //* * //* 1. Create an Installation Manager if you have not already * //* done so. You will need to know the path to the binaries * //* directory for the Installation Manager. * //* * //* 1. Edit and submit Installation Manager sample job GIN3CRED * //* to create a credentials file containing your IBM user ID * //* and password (along with proxy server credentials if you * //* use a proxy server to access the internet from your z/OS * //* system). //* * //* 2. Edit and submit sample job GIN3CFS in SGINJCL to create * //* and mount a filesystem for the new product install. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See Installation Manager sample job * //* GIN2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/global/instmgr/bin' to the path for the Installation * //* Manager binaries, if you have chosen a different location. * //* * //* 3) Immediately after 'imcl install', change 'package.name' to * //* the Installation Manager package name for the product to be * //* installed. * //* * //* You can specify that a particular level of the product is to * //* be installed by adding an underscore (_) and the desired * //* level. For example: * //* * //* install com.ibm.websphere.zOS.v90_9.0.1_20161130_1036 * //* * //* Use the Installation Manager command listAvailablePackages * //* to display the available product levels. * //* * //* If you do not specify a product level, the product will be * //* installed at the latest level contained in the repository. * //* * //* 4) Change '/global/instmgr/products/product/level' to the path * //* at which the product will be installed. (This should match * //* the path specified in GIN3CFS.) * //* * //* 5) Change '/global/instmgr/sharedResources' to the path for the * //* Installation Manager shared resources directory, if you have * //* chosen a different location. This value is set once per * //* Installation Manager, when the first product install is * //* performed, and cannot be changed by a later install. * //* * //* 6) In the '-repositories' parameter, change 'package.name' * //* to the Installation Manager package name for the product to * //* be installed. You can also specify a repository URL of: * //* * //* http://www.ibm.com/software/repositorymanager/entitled * //* * //* but this is far slower than specifying the repository for the * //* particular product to be installed. * //* * //* 6) If you need to use a proxy server to access the Internet, * //* change 'proxy.hostname' and 'proxy_port' to the host name * //* and port for your proxy server. Your Installation Manager * //* credentials file must also contain any required credentials * //* to access the proxy server; see sample job GIN3CRED. * //* * //* If you do NOT need to use a proxy server to access the * //* Internet, delete the five lines following the line that * //* begins with '-preferences'. Do not delete the '-preferences' * //* line or the line containing the text 'preserveDownloaded'. * //* * //* 7) Change '$HOME/im.ssf' to the path and file name of the * //* credentials file you created with GIN3CRED. * //* * //* Change '$HOME/im.mpw' to the path and file name of your * //* master password file. * //* * //* Both files must be readable by the user ID under which this * //* job is run. * //* * //* 8) The license text for this product can be found in the lafiles * //* directory in the root of the product repository. You can * //* also display the license with the imcl viewLicense command. * //* * //* By including -acceptLicense in the command you submit below, * //* you are indicating that you accept the terms of the license. * //* You must accept the license in order to install and use the * //* software. * //* * //* NOTE: Individual products may have have specific Installation * //* Manager properties or options which must be specified at * //* installation time. See the product documentation for details. * //* See the install command here is provided as an example only. * //* * //* 9) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to make sure that the * //* product installation was successful. * //* * //* Logs for product installation can be found in the logs * //* subdirectory of the Installation Manager run-time data; e.g. * //* * //* /global/instmgr/appdata/logs * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes IBM Installation Manager to * //* install a product from the web-based product and service * //* repository. * //**************************************************************** //INSTALL EXEC PGM=IKJEFT01,REGION=0M,MEMLIMIT=NOLIMIT //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + install package.name + -installationDirectory + /global/instmgr/products/product/level + -sharedResourcesDirectory + /global/instmgr/products/sharedResources + -repositories http://www.ibm.com/software/repositorymanager/+ package.name + -preferences + com.ibm.cic.common.core.preferences.http.proxyEnabled=True,+ com.ibm.cic.common.core.preferences.http.proxyHost=+ proxy.hostname,+ com.ibm.cic.common.core.preferences.http.proxyPort=+ proxy_port,+ com.ibm.cic.common.core.preferences.preserveDownloaded+ Artifacts=false + -secureStorageFile $HOME/im.ssf + -masterPasswordFile $HOME/im.mpw + -installFixes recommended + -acceptLicense /* ./ ADD NAME=GIN3INSL //GIN3INSL JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job installs a product from a local product repository. * //* * //* Before running this job: * //* * //* 1. Create an Installation Manager if you have not already * //* done so. You will need to know the path to the binaries * //* directory for the Installation Manager. * //* * //* 2. Obtain the base product repository file from the product * //* media or from ShopzSeries, and transfer it in binary to * //* your z/OS system. * //* * //* We recommend that you create a repo subdirectory in your * //* Installation Manager file system for repository zip files. * //* Since these files are large, you may want to create a * //* separate file system for them. You can use the Installation * //* Manager sample job GIN2REPO to create and mount this file * //* system. * //* * //* 3. If service repositories are available from Fix Central * //* (http://www.ibm.com/support/fixcentral), download them and * //* transfer them in binary to your z/OS system. * //* * //* Keep these files in the same location as the base product * //* repository files. Make sure all files can be read by the * //* Installation Manager user ID. * //* * //* 4. Edit and submit sample job GIN3CFS in SGINJCL to create * //* and mount a filesystem for the new product install. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See Installation Manager sample job * //* GIN2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/global/instmgr/bin' to the path for the Installation * //* Manager binaries, if you have chosen a different location. * //* * //* 3) Immediately after 'imcl install', change 'package.name' to * //* the Installation Manager package name for the product to be * //* installed. * //* * //* You can specify that a particular level of the product is to * //* be installed by adding an underscore (_) and the desired * //* level. For example: * //* * //* install com.ibm.websphere.zOS.v90_9.0.1_20161130_1036 * //* * //* Use the Installation Manager command listAvailablePackages * //* to display the available product levels. * //* * //* If you do not specify a product level, the product will be * //* installed at the latest level contained in the repositories * //* you provide in the -repositories list. * //* * //* 4) Change '/global/instmgr/products/product/level' to the path * //* at which the product will be installed. (This should match * //* the path specified in GIN3CFS.) * //* * //* 5) Change '/global/instmgr/sharedResources' to the path for the * //* Installation Manager shared resources directory, if you have * //* chosen a different location. This value is set once per * //* Installation Manager, when the first product install is * //* performed, and cannot be changed by a later install. * //* * //* 6) Change '/global/instmgr/repo' to the directory that contains * //* the product repositories. Make sure all files can be read by * //* your Installation Manager user ID. * //* * //* Change the file names of the base product repository and * //* service repository to match the names of the actual files. * //* If only one repository is needed, then delete the second * //* repository filename, along with the comma after the first (* //* repository filename. If more than two repository files are * //* required, list them separated by commas. * //* * //* 7) The license text for this product can be found in the lafiles * //* dirctory in the root of the product repository. * //* * //* By including -acceptLicense in the command you submit below, * //* you are indicating that you accept the terms of the license. * //* You must accept the license in order to install and use the * //* software. * //* * //* 8) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to make sure that the * //* product installation was successful. * //* * //* Logs for product installation can be found in the logs * //* subdirectory of the Installation Manager run-time data; e.g. * //* * //* /global/instmgr/appdata/logs * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes IBM Installation Manager to * //* install a product from local product and service * //* repositories. * //**************************************************************** //INSTALL EXEC PGM=IKJEFT01,REGION=0M,MEMLIMIT=NOLIMIT //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + install package.name + -installationDirectory + /global/instmgr/products/product/level + -sharedResourcesDirectory + /global/instmgr/sharedResources + -repositories + /global/instmgr/repo/product.repository,+ /global/instmgr/repo/service.repository + -preferences + com.ibm.cic.common.core.preferences.preserveDownloaded+ Artifacts=false + -acceptLicense /* ./ ADD NAME=GIN3INSP //GIN3INSP JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job installs a product from the web-based product * //* repository. * //* * //* Before running this job: * //* * //* 1. Edit and submit Installation Manager sample job GIN3CRED * //* to create a credentials file containing your IBM user ID * //* and password (along with proxy server credentials if you * //* use a proxy server to access the internet from your z/OS * //* system). //* * //* 2. Edit and submit sample job GIN3CFSP in SGINJCL to create * //* and mount a filesystem for the new product install. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See Installation Manager sample job * //* GIN2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Immediately after 'imcl install', change 'package.name' to * //* the Installation Manager package name for the product to be * //* installed. * //* * //* You can specify that a particular level of the product is to * //* be installed by adding an underscore (_) and the desired * //* level. For example: * //* * //* install com.ibm.websphere.zOS.v90_9.0.1_20161130_1036 * //* * //* Use the Installation Manager command listAvailablePackages * //* to display the available product levels. * //* * //* If you do not specify a product level, the product will be * //* installed at the latest level contained in the repository. * //* * //* 4) Change $INSTALL to the portable install name, the directory * //* in /global/instmgr which will contain the installed product * //* and its Installation Manager metata and logs. (This value * //* should match the value specified in BBO1CFS.) * //* * //* Note that $INSTALL must be changed in several places. * //* * //* 5) Change $PRODUCT to a product identifier which will identify * //* the specific product within the portable install. For * //* example, "was" for WebSphere Application Server, or "ihs" * //* for IBM HTTP Server. * //* * //* 6) In the '-repositories' parameter, change 'package.name' * //* to the Installation Manager package name for the product to * //* be installed. You can also specify a repository URL of: * //* * //* http://www.ibm.com/software/repositorymanager/entitled * //* * //* but this is far slower than specifying the repository for the * //* particular product to be installed. * //* * //* 6) If you need to use a proxy server to access the Internet, * //* change 'proxy.hostname' and 'proxy_port' to the host name * //* and port for your proxy server. Your Installation Manager * //* credentials file must also contain any required credentials * //* to access the proxy server; see sample job GIN3CRED. * //* * //* If you do NOT need to use a proxy server to access the * //* Internet, delete the five lines following the line that * //* begins with '-preferences'. Do not delete the '-preferences' * //* line or the line containing the text 'preserveDownloaded'. * //* * //* 7) Change '$HOME/im.ssf' to the path and file name of the * //* credentials file you created with GIN3CRED. * //* * //* Change '$HOME/im.mpw' to the path and file name of your * //* master password file. * //* * //* Both files must be readable by the user ID under which this * //* job is run. * //* * //* 8) The license text for this product can be found in the lafiles * //* directory in the root of the product repository. You can * //* also display the license with the imcl viewLicense command. * //* * //* By including -acceptLicense in the command you submit below, * //* you are indicating that you accept the terms of the license. * //* You must accept the license in order to install and use the * //* software. * //* * //* NOTE: Individual products may have have specific Installation * //* Manager properties or options which must be specified at * //* installation time. See the product documentation for details. * //* See the install command here is provided as an example only. * //* * //* 9) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to make sure that the * //* product installation was successful. * //* * //* Logs for product installation can be found in the logs * //* subdirectory of the Installation Manager run-time data; e.g. * //* * //* /global/instmgr/$INSTALL/.im/appdata/logs * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes IBM Installation Manager to * //* install a product from the web-based product and service * //* repository. * //**************************************************************** //INSTALL EXEC PGM=IKJEFT01,REGION=0M,MEMLIMIT=NOLIMIT //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + install package.name + -dataLocation + /global/instmgr/$INSTALL/.im/appdata + -installationDirectory + /global/instmgr/$INSTALL/$PRODUCT + -sharedResourcesDirectory + /global/instmgr/$INSTALL/.im/sharedResources + -repositories http://www.ibm.com/software/repositorymanager/+ package.name + -preferences + com.ibm.cic.common.core.preferences.http.proxyEnabled=True,+ com.ibm.cic.common.core.preferences.http.proxyHost=+ proxy.hostname,+ com.ibm.cic.common.core.preferences.http.proxyPort=+ proxy_port,+ com.ibm.cic.common.core.preferences.preserveDownloaded+ Artifacts=false + -secureStorageFile $HOME/im.ssf + -masterPasswordFile $HOME/im.mpw + -accessRights group + -installFixes recommended + -acceptLicense /* ./ ADD NAME=GIN3INSQ //GIN3INSQ JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-WAS (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HBBO900 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job installs a product from a local product repository. * //* * //* Before running this job: * //* * //* 1. Obtain the base product repository file from the product * //* media or from ShopzSeries, and transfer it in binary to * //* your z/OS system. * //* * //* We recommend that you create a repo subdirectory in your * //* Installation Manager file system for repository zip files. * //* Since these files are large, you may want to create a * //* separate file system for them. You can use the Installation * //* Manager sample job GIN2REPO to create and mount this file * //* system. * //* * //* 2. If service repositories are available from Fix Central * //* (http://www.ibm.com/support/fixcentral), download them and * //* transfer them in binary to your z/OS system. * //* * //* Keep these files in the same location as the base product * //* repository files. Make sure all files can be read by the * //* Installation Manager user ID. * //* * //* 3. Edit and submit sample job GIN3CFS in SGINJCL to create * //* and mount a filesystem for the new product install. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See Installation Manager sample job * //* GIN2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Immediately after 'imcl install', change 'package.name' to * //* the Installation Manager package name for the product to be * //* installed. * //* * //* You can specify that a particular level of the product is to * //* be installed by adding an underscore (_) and the desired * //* level. For example: * //* * //* install com.ibm.websphere.zOS.v90_9.0.1_20161130_1036 * //* * //* Use the Installation Manager command listAvailablePackages * //* to display the available product levels. * //* * //* If you do not specify a product level, the product will be * //* installed at the latest level contained in the repositories * //* you provide in the -repositories list. * //* * //* 4) Change $INSTALL to the portable install name, the directory * //* in /global/instmgr which will contain the installed product * //* and its Installation Manager metata and logs. (This value * //* should match the value specified in BBO1CFS.) * //* * //* Note that $INSTALL must be changed in several places. * //* * //* 5) Change $PRODUCT to a product identifier which will identify * //* the specific product within the portable install. For * //* example, "was" for WebSphere Application Server, or "ihs" * //* for IBM HTTP Server. * //* * //* 6) Change '/global/instmgr/repo' to the directory that contains * //* the product repositories. Make sure all files can be read by * //* your Installation Manager user ID. * //* * //* Change the file names of the base product repository and * //* service repository to match the names of the actual files. * //* If only one repository is needed, then delete the second * //* repository filename, along with the comma after the first (* //* repository filename. If more than two repository files are * //* required, list them separated by commas. * //* * //* 7) The license text for this product can be found in the lafiles * //* dirctory in the root of the product repository. * //* * //* By including -acceptLicense in the command you submit below, * //* you are indicating that you accept the terms of the license. * //* You must accept the license in order to install and use the * //* software. * //* * //* 8) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to make sure that the * //* product installation was successful. * //* * //* Logs for product installation can be found in the logs * //* subdirectory of the Installation Manager run-time data; e.g. * //* * //* /global/instmgr/$INSTALL/.im/appdata/logs * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes IBM Installation Manager to * //* install a product from local product and service * //* repositories. * //**************************************************************** //INSTALL EXEC PGM=IKJEFT01,REGION=0M,MEMLIMIT=NOLIMIT //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + install package.name + -dataLocation + /global/instmgr/$INSTALL/.im/appdata + -installationDirectory + /global/instmgr/$INSTALL/$PRODUCT + -sharedResourcesDirectory + /global/instmgr/$INSTALL/.im/sharedResources + -repositories + /global/instmgr/repo/product.repository,+ /global/instmgr/repo/service.repository + -preferences + com.ibm.cic.common.core.preferences.preserveDownloaded+ Artifacts=false + -accessRights group + -acceptLicense /* ./ ADD NAME=GIN3LSTA //GIN3LSTA JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job lists the available packages and fix packs that you * //* are entitled to install from the Web-based product and service * //* repository. * //* * //* Before running this job, create an Installation Manager (sample * //* jobs GIN2ADMN, GIN2CFS, and GIN2INST) and create master password * //* and credentials files (sample job GIN3CRED). * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See InstallationManager sample job * //* GIM2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/global/instmgr/bin' to the path for the Installation * //* Manager binaries, if you have chosen a different location. * //* * //* 3) This job will list ALL your entitled packages and fix packs, * //* and the job may run for some time. You can restrict the list * //* to a specific offering by changing 'enabled' to the offering * //* name of the product you are interested in (for example, * //* com.ibm.websphere.zOS.v90). * //* * //* 4) If you need to use a proxy server to access the Internet, * //* change proxy.hostname and proxy_port to the host name and * //* port for the proxy server, and change proxy_username and * //* proxy_password to the user name and password for proxy * //* server authentication. The proxy server credentials will * //* be saved in the same file with your repository credentials. * //* * //* If you do NOT need to use a proxy server to access the * //* Internet, delete the six lines beginning with '-preferences'. * //* * //* 5) Change '$HOME/im.ssf' to the path and file name of the * //* credentials file you created with GIN3CRED. * //* * //* Change '$HOME/im.mpw' to the path and file name of your * //* master password file. * //* * //* Both files must be readable by the user ID under which this * //* job is run. * //* * //* 6) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to determine the offering * //* IDs and fix pack levels that are available in the repository. * //* * //********************************************************************* //* //**************************************************************** //* The following step lists the packages and fix packs that * //* you can install from the Web-based product and service * //* repository. * //**************************************************************** //LISTREPO EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + listAvailablePackages + -repositories http://www.ibm.com/software/repositorymanager/+ entitled + -preferences + com.ibm.cic.common.core.preferences.http.proxyEnabled=True,+ com.ibm.cic.common.core.preferences.http.proxyHost=+ proxy.hostname,+ com.ibm.cic.common.core.preferences.http.proxyPort=+ proxy_port + -secureStorageFile $HOME/im.ssf + -masterPasswordFile $HOME/im.mpw /* //* ./ ADD NAME=GIN3LSTB //GIN3LSTB JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job lists the available packages and fix packs that you * //* are entitled to install from the Web-based product and service * //* repository. * //* * //* Before running this job, create an Installation Manager (sample * //* jobs GIN2ADMN, GIN2CFS, and GIN2INST) and create master password * //* and credentials files (sample job GIN3CRED). * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See InstallationManager sample job * //* GIM2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) This job will list ALL your entitled packages and fix packs, * //* and the job may run for some time. You can restrict the list * //* to a specific offering by changing 'enabled' to the offering * //* name of the product you are interested in (for example, * //* com.ibm.websphere.zOS.v90). * //* * //* 4) If you need to use a proxy server to access the Internet, * //* change proxy.hostname and proxy_port to the host name and * //* port for the proxy server, and change proxy_username and * //* proxy_password to the user name and password for proxy * //* server authentication. The proxy server credentials will * //* be saved in the same file with your repository credentials. * //* * //* If you do NOT need to use a proxy server to access the * //* Internet, delete the six lines beginning with '-preferences'. * //* * //* 5) Change '$HOME/im.ssf' to the path and file name of the * //* credentials file you created with GIN3CRED. * //* * //* Change '$HOME/im.mpw' to the path and file name of your * //* master password file. * //* * //* Both files must be readable by the user ID under which this * //* job is run. * //* * //* 6) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to determine the offering * //* IDs and fix pack levels that are available in the repository. * //* * //********************************************************************* //* //**************************************************************** //* The following step lists the packages and fix packs that * //* you can install from the Web-based product and service * //* repository. * //**************************************************************** //LISTREPO EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + listAvailablePackages + -repositories http://www.ibm.com/software/repositorymanager/+ entitled + -preferences + com.ibm.cic.common.core.preferences.http.proxyEnabled=True,+ com.ibm.cic.common.core.preferences.http.proxyHost=+ proxy.hostname,+ com.ibm.cic.common.core.preferences.http.proxyPort=+ proxy_port + -secureStorageFile $HOME/im.ssf + -masterPasswordFile $HOME/im.mpw /* //* ./ ADD NAME=GIN3LSTF //GIN3LSTF JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job lists the corrective service (interim fixes, or iFixes) * //* which are available for a particular product levels from the * //* web-based service repository. * //* * //* Before running this job, create an Installation Manager (sample * //* jobs GIN2ADMN, GIN2CFS, and GIN2INST) and create master password * //* and credentials files (sample job GIN3CRED). * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See InstallationManager sample job * //* GIM2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/global/instmgr/bin' to the path for the * //* Installation Manager binaries, if you have chosen a different * //* location. * //* * //* 3) Change 'package.name_level' to the package name and EXACT * //* level of the product for which you need corrective service. * //* For example: * //* * //* com.ibm.websphere.zOS.v90_9.0.1_20161130_1036 * //* * //* Use the imcl listInstalledPackages command to determine the * //* current level of a particular installed product. * //* (See sample job GIN3LSTI for the format of this command.) * //* * //* 4) In the '-repositories' parameter, change 'package.name' * //* to the Installation Manager package name of the product for * //* which you need corrective service. * //* * //* 5) If you need to use a proxy server to access the Internet, * //* change proxy.hostname and proxy_port to the host name and * //* port for the proxy server, and change proxy_username and * //* proxy_password to the user name and password for proxy * //* server authentication. The proxy server credentials will * //* be saved in the same file with your repository credentials. * //* * //* If you do NOT need to use a proxy server to access the * //* Internet, delete the six lines beginning with '-preferences'. * //* * //* 6) Change '$HOME/im.ssf' to the path and file name of the * //* credentials file you created with GIN3CRED. * //* * //* Change '$HOME/im.mpw' to the path and file name of your * //* master password file. * //* * //* Both files must be readable by the user ID under which this * //* job is run. * //* * //* 7) This job will display extensive information for each * //* available fix. For a simple list of available fixes, * //* remove the '-long' option. * //* * //* 8) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to determine the offering * //* IDs and fix pack levels that are available in the repository. * //* * //********************************************************************* //* //**************************************************************** //* The following step lists the packages and fix packs that * //* you can install from the Web-based product and service * //* repository. * //**************************************************************** //LISTREPO EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + listAvailableFixes + package.name_level + -long + -repositories http://www.ibm.com/software/repositorymanager/+ package.name + -preferences + com.ibm.cic.common.core.preferences.http.proxyEnabled=True,+ com.ibm.cic.common.core.preferences.http.proxyHost=+ proxy.hostname,+ com.ibm.cic.common.core.preferences.http.proxyPort=+ proxy_port + -secureStorageFile $HOME/im.ssf + -masterPasswordFile $HOME/im.mpw /* //* ./ ADD NAME=GIN3LSTG //GIN3LSTG JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job lists the corrective service (interim fixes, or iFixes) * //* which are available for a particular product levels from the * //* web-based service repository. * //* * //* Before running this job, create an Installation Manager (sample * //* jobs GIN2ADMN, GIN2CFS, and GIN2INST) and create master password * //* and credentials files (sample job GIN3CRED). * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See InstallationManager sample job * //* GIM2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Change 'package.name_level' to the package name and EXACT * //* level of the product for which you need corrective service. * //* For example: * //* * //* com.ibm.websphere.zOS.v90_9.0.1_20161130_1036 * //* * //* Use the imcl listInstalledPackages command to determine the * //* current level of a particular installed product. * //* (See sample job GIN3LSTI for the format of this command.) * //* * //* 4) In the '-repositories' parameter, change 'package.name' * //* to the Installation Manager package name of the product for * //* which you need corrective service. * //* * //* 5) If you need to use a proxy server to access the Internet, * //* change proxy.hostname and proxy_port to the host name and * //* port for the proxy server, and change proxy_username and * //* proxy_password to the user name and password for proxy * //* server authentication. The proxy server credentials will * //* be saved in the same file with your repository credentials. * //* * //* If you do NOT need to use a proxy server to access the * //* Internet, delete the six lines beginning with '-preferences'. * //* * //* 6) Change '$HOME/im.ssf' to the path and file name of the * //* credentials file you created with GIN3CRED. * //* * //* Change '$HOME/im.mpw' to the path and file name of your * //* master password file. * //* * //* Both files must be readable by the user ID under which this * //* job is run. * //* * //* 7) This job will display extensive information for each * //* available fix. For a simple list of available fixes, * //* remove the '-long' option. * //* * //* 8) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to determine the offering * //* IDs and fix pack levels that are available in the repository. * //* * //********************************************************************* //* //**************************************************************** //* The following step lists the packages and fix packs that * //* you can install from the Web-based product and service * //* repository. * //**************************************************************** //LISTREPO EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + listAvailableFixes + package.name_level + -long + -repositories http://www.ibm.com/software/repositorymanager/+ package.name + -preferences + com.ibm.cic.common.core.preferences.http.proxyEnabled=True,+ com.ibm.cic.common.core.preferences.http.proxyHost=+ proxy.hostname,+ com.ibm.cic.common.core.preferences.http.proxyPort=+ proxy_port + -secureStorageFile $HOME/im.ssf + -masterPasswordFile $HOME/im.mpw /* //* ./ ADD NAME=GIN3LSTI //GIN3LSTI JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job lists the packages and fixes that have been installed * //* with IBM Installation Manager. * //* * //* Before running this job, create an Installation Manager * //* (sample jobs GIN2ADMN, GIN2CFS, and GIN2INST) * //* and install one or more products. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See InstallationManager sample job * //* GIM2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/global/instmgr/bin' to the path for the Installation * //* Manager binaries, if you have chosen a different location. * //* * //* 3) This job will display extensive information for each * //* ibstalled package (-verbose). For a shorter list, change * //* '-verbose' to '-long', or omit it entirely. * //* * //* 4) This job will list ALL your installed packages. To restrict * //* the list to products and fixes installed into a particular * //* directory, add a -installationDirectory (-iD) parameter to * //* the imcl listInstalledPackages command: * //* * //* -iD /global/instmgr/products/WebSphere/AppServer/9.0 * //* * //* 5) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to determine the offering * //* IDs and fix pack levels that are available in the repository. * //* * //********************************************************************* //* //**************************************************************** //* The following step lists the packages that are have been * //* installed with this Installation Manager. * //**************************************************************** //LISTINST EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + listInstalledPackages -verbose /* ./ ADD NAME=GIN3LSTJ //GIN3LSTJ JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job lists the packages and fixes that have been installed * //* with IBM Installation Manager in a particular portable install. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See InstallationManager sample job * //* GIM2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Change $INSTALL to the portable install name, the directory * //* in /global/instmgr which contains the installed product * //* and its Installation Manager metata and logs. * //* * //* Note that $INSTALL must be changed in several places. * //* * //* 4) This job will display extensive information for each * //* ibstalled package (-verbose). For a shorter list, change * //* '-verbose' to '-long', or omit it entirely. * //* * //* 5) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to determine the offering * //* IDs and fix pack levels that are available in the repository. * //* * //********************************************************************* //* //**************************************************************** //* The following step lists the packages that are have been * //* installed with this Installation Manager. * //**************************************************************** //LISTINST EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + listInstalledPackages -verbose + -dataLocation + /global/instmgr/$INSTALL/.im/appdata + -accessRights group /* ./ ADD NAME=GIN3LSTL //GIN3LSTL JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job lists the available packages and fix packs that you * //* are entitled to install from a local product or service * //* repository. * //* * //* Before running this job, create an Installation Manager (sample * //* jobs GIN2ADMN, GIN2CFS, and GIN2INST). * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See InstallationManager sample job * //* GIM2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/global/instmgr/bin' to the path for the Installation * //* Manager binaries, if you have chosen a different locatiom. * //* location. * //* * //* 3) Change '/global/instmgr/repo' to the path for the directory * //* in which the repository is stored. * //* * //* 4) Change 'repository.zip' to the filename of the repository * //* file. If you want to list the contents of several * //* repositories with one command, you can lis them (with the * //* complete path for each), separated by commas. * //* * //* Verify that all repository zip files can be read by the * //* user ID that invokes the imcl command. * //* * //* 6) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to determine the offering * //* IDs and fix pack levels that are available in the repository. * //* * //********************************************************************* //* //**************************************************************** //* The following step lists the packages and package levels * //* that you can install from a local product or service * //* repository. * //**************************************************************** //LISTREPO EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + listAvailablePackages + -repositories + /global/instmgr/repo/repository.zip /* //* ./ ADD NAME=GIN3LSTM //GIN3LSTM JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job lists the available packages and fix packs that you * //* are entitled to install from a local product or service * //* repository. * //* * //* Before running this job, create an Installation Manager (sample * //* jobs GIN2ADMN, GIN2CFS, and GIN2INST). * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. (See InstallationManager sample job * //* GIM2ADMN for a description of the required privileges.) * //* * //* For a group-mode Installation Manager, run this job under a * //* user ID connected to the group that owns the Installation * //* Manager. If this group is not the default group for the user * //* ID, specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* For an admin-mode Installation Manager, run this job under a * //* superuser (uid 0) ID. * //* * //* For a user-mode Installation Manager, run this job under the * //* user ID that owns the Installation Manager. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Change '/global/instmgr/repo' to the path for the directory * //* in which the repository is stored. * //* * //* 4) Change 'repository.zip' to the filename of the repository * //* file. If you want to list the contents of several * //* repositories with one command, you can lis them (with the * //* complete path for each), separated by commas. * //* * //* Verify that all repository zip files can be read by the * //* user ID that invokes the imcl command. * //* * //* 6) Make sure that each line of the //SYSTSIN input stream ends * //* with the continuation character (+) except for the last line, * //* which should not end with a continuation character. * //* * //* Submit the job, and examine the output to determine the offering * //* IDs and fix pack levels that are available in the repository. * //* * //********************************************************************* //* //**************************************************************** //* The following step lists the packages and package levels * //* that you can install from a local product or service * //* repository. * //**************************************************************** //LISTREPO EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + listAvailablePackages + -repositories + /global/instmgr/repo/repository.zip /* //* ./ ADD NAME=GIN3UNIN //GIN3UNIN JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job uninstalls a product with IBM Installation Manager. * //* * //* The user ID used to run this job must have the authority to * //* invoke the Installation Manager: * //* * //* Group-mode Installation Manager (created with groupinstc) * //* Invoking user ID must be connected to the default group of * //* the user ID that created the Installation Manager, and * //* must also have access to the SAF profiles outllined in * //* sample job GIN2ADMN. * //* * //* Admin-mode Installation Manager (created with installc) * //* Invoking user ID must be a superuser, and have access to * //* the SAF profiles outlined in sample job GIN2ADMN. * //* * //* User-mode Installation Manager (created with userinstc) * //* Invoking user ID must be the user ID that created the * //* Installation Manager, and have access to the SAF profiles * //* outlined in sample job GIN2ADMN. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. * //* * //* If a group-mode Installation Manager is being used, then * //* this job must also run under the Unix System Services group * //* associated with the Installation Manager. If necessary, you * //* can specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* 2) Change '/global/instmgr/bin' to the path for the Installation * //* Manager binaries, if you have chosen a different location. * //* * //* 3) Change 'package.id' to the package name of the product to be * //* uninstalled. The package name can be found in the product * //* documentation for the product being uninstalled; you can * //* also display this information with the Installation Manager * //* command listInstalledPackages (see the GIN3LSTI sample job). * //* * //* 4) Change '/global/instmgr/products/product/level' to the * //* installation directory of the product to be uninstalled. * //* * //* Submit the job, and examine the output to make sure that the * //* uninstallation was successful. * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes the IBM Installation Manager * //* command line tool to uninstall a product. * //**************************************************************** //UNINSTAL EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /global/instmgr/bin/eclipse/tools/imcl + uninstall package.id + -installationDirectory + /global/instmgr/products/product/level /* ./ ADD NAME=GIN3UNIP //GIN3UNIP JOB //********************************************************************* //* Licensed Material - Property of IBM * //* 5655-IMZ (C) Copyright IBM Corp. 2000, 2020 * //* * //* All Rights Reserved. * //* U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or * //* Disclosure restricted by GSA-ADP schedule contract with IBM Corp. * //* * //* Status = HGIN140 * //* _________________________________________________________________ * //* * //* This job is intended for use with "portable" IBM Installation * //* Manager product installs, which contain their own Installation * //* Manager metadata and can be moved easily to other z/OS systems. * //* For more information, see the following IBM technote: * //* * //* www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/TD106438 * //* _________________________________________________________________ * //* * //* This job uninstalls a product with IBM Installation Manager. * //* * //* The user ID used to run this job must have the authority to * //* invoke the Installation Manager: * //* * //* Group-mode Installation Manager (created with groupinstc) * //* Invoking user ID must be connected to the default group of * //* the user ID that created the Installation Manager, and * //* must also have access to the SAF profiles outllined in * //* sample job GIN2ADMN. * //* * //* Admin-mode Installation Manager (created with installc) * //* Invoking user ID must be a superuser, and have access to * //* the SAF profiles outlined in sample job GIN2ADMN. * //* * //* User-mode Installation Manager (created with userinstc) * //* Invoking user ID must be the user ID that created the * //* Installation Manager, and have access to the SAF profiles * //* outlined in sample job GIN2ADMN. * //* * //* CAUTION: This is neither a JCL procedure nor a complete job. * //* Before using this job step, you will have to make the following * //* modifications: * //* * //* 1) Add the job parameters to meet your system requirements. * //* Make sure the job will run under a user ID with access to * //* the appropriate group and privileges, and a read/write * //* home directory. * //* * //* If a group-mode Installation Manager is being used, then * //* this job must also run under the Unix System Services group * //* associated with the Installation Manager. If necessary, you * //* can specify the GROUP= parameter on the JOB statement to * //* cause the job to run under the Installation Manager group. * //* * //* 2) Change '/usr/lpp/InstallationManager/V1R4' to the path for * //* the Installation Manager product code (installer). * //* * //* 3) Change 'package.id' to the package name of the product to be * //* uninstalled. The package name can be found in the product * //* documentation for the product being uninstalled; you can * //* also display this information with the Installation Manager * //* command listInstalledPackages (see the GIN3LSTI sample job). * //* * //* 4) Change $INSTALL to the portable install name, the directory * //* in /global/instmgr which contains the installed product * //* and its Installation Manager metata and logs. * //* * //* Note that $INSTALL must be changed in several places. * //* * //* 5) Change $PRODUCT to a product identifier for the specific * //* product within the portable install which is to be * //* uninstalled. * //* * //* Submit the job, and examine the output to make sure that the * //* uninstallation was successful. * //* * //********************************************************************* //* //**************************************************************** //* The following step invokes the IBM Installation Manager * //* command line tool to uninstall a product. * //**************************************************************** //UNINSTAL EXEC PGM=IKJEFT01,REGION=0M //SYSTSPRT DD SYSOUT=* //BPXOUT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH + /usr/lpp/InstallationManager/V1R4/tools/imcl + uninstall package.id + -dataLocation + /global/instmgr/$INSTALL/.im/appdata + -installationDirectory + /global/instmgr/$INSTALL/$PRODUCT + -accessRights group /* $$ /*