Creating a PPC Gateway server

You can create a PPC Gateway server by using the cicsppcgwycreate command. The following steps show how to use the cicsppcgwycreate command and suggest a simple naming convention for the PPC Gateway server's resource definitions.

  1. Decide on a one- to eight-character server_name for the PPC Gateway server (for example, cicsgwy).
  2. Create a logical volume of about one partition (4 MB) called log_server_name (for example, log_cicsgwy). These procedures that are used to create a logical volume differ according to platform. See the bulleted points listed under this step for specific instructions on how to create a logical volume for your platform. In these steps, server_name represents the name of the PPC Gateway server.
    • To set up the PPC Gateway server and create a logical volume on the AIX® platform:
      1. Enter the following command to create the logical volume:
        mklv -y log_server_name rootvg 4

        This command places a logical volume named log_server_name in the /dev directory. If possible, mirror this volume across more than one physical disk.

      2. Grant the read and write permission to the logical volume to cics and the associated raw device by issuing the following commands:
        chown cics:cics/dev/log_server_name
        chown cics:cics/dev/log_server_name
    • To set up the PPC Gateway server and create a logical volume on the HP-UX platform, consult your HP documentation for information about how to use the HP System Administration Manager (SAM). If the logical volume is created on a volume group other than vg00, export the environment variable CICS_PPCGWY_VG to the name of the volume group that was used before starting the PPC Gateway server.
    • To set up the PPC Gateway server and create a logical volume on the Windows platform:
      1. Change to the directory C:\var\cics_servers\GSD\cics\ppc\gateway\ by entering the command:
        cd C:\var\cics_servers\GSD\cics\ppc\gateway\
      2. Make a new directory called server_name by entering the command:
        mkdir server_name
      3. Enter the following command to create the logical volume:
        cicsmakelv -v log_svr_name -s volumeSize -p C:\var\log_Pserver_name
  3. Follow the instructions under Viewing the attributes of a PPC Gateway server to view the default values of the GSD attributes that will be assigned to the new PPC Gateway server.
  4. Use one of the methods that are outlined under Changing the attributes of a PPC Gateway server to change the default values of the following attributes:
    • Change the ShortName attribute of the GSD from the default of PPCGWY to the server_name that is defined in step 1 because:
      • The value for the ShortName attribute must be unique among all PPC Gateway servers that are defined on the machine.
      • The value for the ShortName attribute affects the default value of theLogVolume attributes. If you do not change the ShortName attribute value, you must change the default values of the LogVolume attributes to the logical volume that was created in step 2.
  5. Issue the cicsppcgwycreate command to create the PPC Gateway server:
    cicsppcgwycreate /.:/cics/ppc/gateway/server_name 
    This command takes the name of the PPC Gateway server, which is always of the format /.:/cics/ppc/gateway/server_name.
    Note: You can specify changes to GSD attributes with this command. For example, if you want to change the ShortName attribute, the command is:
    cicsppcgwycreate /.:/cics/ppc/gateway/server_name ShortName=svr_name 

    When using HP-IA SNAplus2

    The PPC Gateway server must be configured with the modename that is associated with the Partner LU alias. Specify this value when the PPC Gateway server is created. The following example shows the PPC Gateway server called /.:/cics/ppc/gateway/cicsgwy, with the ShortName attribute changed to cicsgwy and the SNADefaultModeName attribute defined as CICSISC0:
    cicsppcgwycreate /.:/cics/ppc/gateway/cicsgwy ShortName=cicsgwy  \
                     SNADefaultModeName="CICSISC0"