Modify an additional copy of SBJTSAMP to create the Output Manager V3R1 database

In this step, you copy specific members from the SBJTSAMP that was provided with the installation into a separate HLQ, and then modify and submit members BJT@PRE3 and BJT@JCE3 to specify configuration values for the new Output Manager V3R1 database.

  1. Copy BJT@CPY3 from your SMP/E install library to a separate JCL library.
  2. Modify the copy of BJT@CPY3 to specify a new location for the new Output Manager V3R1 libraries:
    • ?BJTHLQ?: The high-level qualifier of the new Output Manager V3R1 product libraries. This high-level qualifier was specified during the installation process, as documented in the Program Directory for Tivoli® Output Manager for z/OS®.
    • ?SAMPHLQ?: Specify a high-level qualifier for the copy of specific members in SBJTSAMP. In the following examples, the value HLQ.BJT@310 is used.
    Note: This version of SBJTSAMP will be used to create the new Output Manager V3R1 database, and should not be in the same high-level qualifier as your existing Output Manager installation, nor in the same high-level qualifier as the SBJTSAMP created in the previous step (HLQ.OLDDB).
  3. Submit the copy of BJT@CPY3.
    BJT@CPY3 creates a copy of the members of SBJTSAMP required to load the new Output Manager database for V3R1.
  4. Modify HLQ.BJT@310.SBJTSAMP(BJT@JCE3). Follow instructions within the member and specify the following configuration parameters:
    • ?BJTHLQ?: The high-level qualifier of the new Output Manager V3R1 product libraries.
    • ?SAMPHLQ?: Specify the high level qualifier for the new HLQ.BJT@310.SBJTSAMP library.
    Important: Never run BJT@JCE3 against your SMPE applied library.
  5. Modify <JOB PARAMETERS> on the job card.
  6. Modify HLQ.BJT@310.SBJTSAMP(BJT@PRE3) to specify the following configuration parameters
    Some parameter values can be reused from the V3.1 BJT@PRED, some can be copied from the V3.1 BJT@PRE2, and some require new values. The Source column of the following table indicates where you can copy the value from (if applicable).
    Table 1. BJT@PRE3 configuration parameters
    Parameter Source Notes
    ?SAMPHLQ? (New) Specify the high-level-qualifier of this version of SBJTSAMP. For example, HLQ.BJT@310. This is the location where you are building the jobs to complete the migration steps.
    ?BJTHLQ? V3.1 BJT@PRED Specify the high-level qualifier of the new Output Manager V3R1 product libraries.
    ?ACCT? V3.1 BJT@PRED Optional parameter for setting up JOB cards.
    ?PROGRAMMER NAME? V3.1 BJT@PRED Optional parameter for setting up JOB cards.
    ?JOBCLASS? V3.1 BJT@PRED Optional parameter for setting up JOB cards.
    ?MSGCLASS? V3.1 BJT@PRED Optional parameter for setting up JOB cards.
    ?SDSNEXIT? V3.1 BJT@PRED ?SDSNEXIT? is the EXIT library for your Db2® subsystem. Specify values for your new Output Manager database.
    ?SDSNLOAD? V3.1 BJT@PRED ?SDSNLOAD? is the Db2 LOAD library for your Db2 subsystem. Specify values for your new Output Manager database.
    ?RUNLIB? V3.1 BJT@PRED ?RUNLIB? is the Db2 RUN library. Specify values for your new Output Manager database.
    ?TEPPLAN? V3.1 BJT@PRED ?TEPPLAN? is the plan name for the DSNTEP2 program. Specify values for your new Output Manager database.
    ?PLANOWNER? V3.1 BJT@PRED Specify the authorization ID of the owner for the plans and packages. If your site has no specific security requirements for the Output Manager database and plans, set this to the user ID that submits the jobs to BIND the packages and plans.
    ?OWNER? V3.1 BJT@PRED Specify the authorization ID of the owner of the new Output Manager database. If your site has no specific security requirements for the database, set this to the user ID that submits the job to create the database.
    ?DB2SSID? V3.1 BJT@PRED Specify values of your new Output Manager database.
    ?BJTBASE? V3.1 BJT@PRED Specify values of your new Output Manager database.
    ?BJTQUAL? V3.1 BJT@PRED Specify values of your new Output Manager database.
    ?BJTPLAN? V3.1 BJT@PRED The ?BJTPLAN? value in HLQ.OLDDB must be different than the value that you specified for ?BJTPLAN? in the HLQ.OLDDB version. The recommended value for this step is BJTPLN3.
    ?BJTCOL? V3.1 BJT@PRED The ?BJTCOL? value in HLQ.OLDDB must be different than the value that you specified for ?BJTCOL? in the HLQ.OLDDB version. The recommended value for this step is BJTCOL3.
    CHANGE DATACLAS (New) This parameter is commented out by default. If your site has a dataclass requirement for this job, remove the comment characters (--) and specify a dataclass. If your site does not have a dataclass requirement, you can leave the comment characters as-is.
    ?REORGHLQ? (New) The high level qualifier that is used to allocate work data sets used by the Db2 REORG utility.
    ?COPYHLQ? (New) The high level qualifier that is used to allocate image copies for the tablespaces.. The name must be 9 characters or less.
    ?UNLDDACL? V3.1 BJT@PRE2 Specify the same dataclass for the unload data sets that was specified in HLQ.OLDDB.SBJTSAMP(BJT@JCE2)
    ?UNLDHLQ? V3.1 BJT@PRE2 Specify the same high-level qualifier for the unload data sets that was specified in HLQ.OLDDB.SBJTSAMP(BJT@JCE2)
    ?NEWBASE? V3.1 BJT@PRE2 Specify values for the new Output Manager V3R1 database to be created.
    ?NEWQUAL? V3.1 BJT@PRE2 Specify values for the new Output Manager V3R1 database to be created.
    ?BJTADMIN? V3.1 BJT@PRED For this security configuration variable, specify the user ID or group of the Output Manager administrator.
    ?PRSET_DSN? (New) The DSN of the library containing the PRSET members used for printing.
    ?BJTHLQ? V3.1 BJT@PRED (This variable must be specified in two locations in BJT@PRE3.) Specify the high-level qualifier of the new Output Manager V3R1 product libraries. This high-level qualifier was specified during the installation process, as documented in the Program Directory for Tivoli Output Manager for z/OS.
  7. If your site security policies require privileges to be defined for each user, make the following edits to these members in HLQ.BJT@310.SBJTSAMP:
    • In BJT@JCLO, uncomment and edit the set of GRANTs in the SYSIN DD for the APPLY step.
    • In BJT@JCLD, uncomment the DD statement for BJT@TBGR in the SYSIN DD for the CREATE step
  8. Submit HLQ.BJT@310.SBJTSAMP(BJT@JCE3). BJT@JCE3 automatically modifies all of the members of the specified SBJTSAMP library according to the values specified in BJT@PRE3.