Starting a PPC Gateway server

The cicsppcgwy command offers two modes for starting a PPC Gateway server. A PPC Gateway server can be cold started. In this mode, the server is passed the name of its logical volume by the cicsppcgwy command and formats its logical volume with a new log file, destroying the recoverable information in the existing log file. Therefore, use a cold start only the first time you start a PPC Gateway server. More frequently, a PPC Gateway server is started in autostart mode. In this mode, the server reads the recoverable information from the existing log file and proceeds as if it had not been shut down.

To start a PPC Gateway server, issue the cicsppcgwy command. If you accept the default StartType attribute value of auto, enter the command:

cicsppcgwy /.:/cics/ppc/gateway/server_name

Note: In this example, the PPC Gateway server server_name is specified explicitly on the command line. You can also pass the server name on an autostart by using the CICS_PPCGWY_SERVER environment variable. In this case, issue the command to specify the variable before issuing the cicsppcgwy command. For example:

export CICS_PPCGWY_SERVER=/.:/cics/ppc/gateway/server_name

(This example assumes that you are using the Korn shell on an Open Systems platform; if you are using a different shell or platform, change the command accordingly.)

If you want to change the StartType attribute value to cold, enter the command:

cicsppcgwy /.:/cics/ppc/gateway/server_name StartType=cold

It is possible to change the PPC Gateway server's ThreadPoolSize and SNADefaultModeName attributes during either a cold start or an autostart.

After the PPC Gateway server is running, your CICS® region can contact it. The region uses a Gateway Definitions (GD) entry to locate the PPC Gateway server. The PPC Gateway server then calls the SNA product to contact the remote system.