Examples of HFM2POPI macros

The following examples show the HFM2POPI statements you would code to change the default values for some ZDT/Db2 options. You include this code in your version of HFM2POPT. (Do not change HFM2POPI in HFM.SHFMMAC1.)
 Example 1 
         HFM2POPI                                                      +
               LIST=ACTIVE,                                            +
               CONNECT=DEFINED,                                        +
               SSIDCMD1=CONNECT,                                       +
               SSIDCMD2=SSID,                                          +
               CATOWNER=SYSIBMV,                                       +
               EDITCAPS=(INITON,PROFILE,CAPSCMD)
 Example 2 
         HFM2POPI                                                      +
               LIST=ALL,                                               +
               CONNECT=ANY,                                            +
               SSIDCMD1=SSID,                                          +
               SSIDCMD2=DB2SYS,                                        +
               CATOWNER=SYSIBM,                                        +
               EDITCAPS=(INITON,FIXED,NOCAPSCMD)
Note: In these examples the + character is in column 72.

 Example 1 

  1. LIST=ACTIVE specifies that only Db2® subsystems that are active (on the local z/OS® system), and any group items, on the subsystem selection list, will be shown.
  2. CONNECT=DEFINED specifies that ZDT/Db2 will only attempt to connect to active Db2 subsystems or groups for which there is an HFM2SSDM macro entry. The Db2 subsystem or group must be active for ZDT/Db2 to attempt the connection.
  3. SSIDCMD1=CONNECT specifies that the word CONNECT can be used as the first command to change the currently connected Db2 subsystem, when entered from ZDT/Db2 panels that support the command. This replaces the default value for SSIDCMD1 of SSID. CONNECT can be abbreviated to CONN.

    SSIDCMD2=SSID specifies that the word SSID can be used as the second command to change the currently connected Db2 subsystem, when entered from ZDT/Db2 panels that support the command. This replaces the default value for SSIDCMD2 of DB2SYS.

    The net effect of these two statements is to define two commands, CONNECT and SSID. CONNECT effectively replaces the DB2SYS command. The SSID command remains available.

  4. CATOWNER=SYSIBMV specifies that the catalog owner for Db2 catalog tables will be SYSIBMV, replacing the default value of SYSIBM. You must ensure that suitable Db2 views, with an owner of SYSIBMV, have been defined for all Db2 catalog tables accessed by ZDT/Db2.
  5. EDITCAPS=(INITON,PROFILE,CAPSCMD) sets the ZDT/Db2 editor caps option as follows:

    For new users the CAPS edit option is set to ON. The initial setting is stored in the user's ISPF profile and can be changed using either the global or local edit option's panels. Each ZDT/Db2 edit session starts with the CAPS command set to the current edit option's setting. The CASE command can be used within any ZDT/Db2 edit session. The only difference between this, and the installation default, (INITOFF,PROFILE,CAPSCMD), is that new users begin with the CAPS edit option set to ON. With the default setting new users begin with the CAPS edit option set to off.

 Example 2 

  1. LIST=ALL specifies that all Db2 subsystems defined with an HFM2SSDM macro entry on the subsystem selection list, whether active or not, will be shown. The exception is any Db2 subsystem defined with DISPLAY=HIDDEN in the appropriate HFM2SSDM macro. Other Db2 systems defined on the local z/OS system, but for which there is no HFM2SSDM macro entry, will also appear on the subsystem selection list.
  2. CONNECT=ANY specifies that ZDT/Db2 will attempt to connect to any active Db2 subsystem or group that appears on the subsystem selection list, regardless of whether there is an HFM2SSDM macro entry for the Db2 subsystem or group.
  3. SSIDCMD1=SSID specifies that the default value (SSID) is to be used as a command that can be used to change the currently connected Db2 subsystem, when entered from ZDT/Db2 panels that support the command.

    SSIDCMD2=DB2SYS specifies that the default value (DB2SYS) is to be used as a second command that can be used to change the currently connected Db2 subsystem, when entered from ZDT/Db2 panels that support the command.

  4. CATOWNER=SYSIBM specifies that the catalog owner for Db2 catalog tables will be SYSIBM, which is the default. ZDT/Db2 will access the Db2 catalog tables directly.
  5. EDITCAPS=(INITON,FIXED,NOCAPSCMD) sets the ZDT/Db2 editor caps option as follows:

    Every ZDT/Db2 edit session starts with the CAPS set to ON. The initial setting cannot be altered using the Edit Options. The editor CAPS command is disabled. The editor CASE command is still available. Lower case data can only be entered by first issuing the editor CASE MIXED command.