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.
- Decide on a one- to eight-character server_name for
the PPC Gateway server (for
example, cicsgwy).
- 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:
- 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.
- 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:
- 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\
- Make a new directory called server_name by
entering the command:
mkdir server_name
- Enter the following command to create the logical volume:
cicsmakelv -v log_svr_name -s volumeSize -p C:\var\log_Pserver_name
- 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.
- 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.
- 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"