Logon to TSO with your normal user name.

There are two alternatives available for allocating the GMCSTARS data sets in this step, using ISPF option 3.2, or using an IEFBR14 job, supplied by Global Maintech.

Things to Consider When Allocating

The load library for GMCSTARS, gmcstars-prefix.GMCSTARS.V1R0.LOAD must be a PDS/E library, and must be authorized. You may wish to specify the volume serial number of the disk it resides on when authorizing. Alternatively, you can specify that SMS will manage the location of the data set. This load library can be any existing authorized library or it can be allocated to GMCSTARS use, only. The library and all other GMCSTARS data sets can be shared between LPARs. STARSIN JCL includes both traditional and SMS variants for allocating the data sets.

1. Use ISPF option 3.2 to allocate the following data sets:

   Table 3.1. ISPF Data Set Allocation Parameters

   Space				DCB Parms.
   Units	Primary	Secondary	Directory Blks.	RECFM	LRECL	BLKSIZE	DSNTYPE
   userid.LOAD.XMIT
   BLKS	5000	1000	0	FB	80	3120	blank
   gmcstars-prefix.GMCSTARS.V1R0.LOAD
   CYLS	40	5	0	U	0	6144	LIBRARY
   gmcstars-prefix.GMCSTARS.V1R0.PARMLIB
   TRKS	2	1	2	FB	80	4080	PDS or LIBRARY
   gmcstars-prefix.GMCSTARS.V1R0.DATA
   TRKS	1	1	1	VB	256	4096	PDS or LIBRARY

2. A STARSINS job is provided in INSTALL.XMIT. You can download this job and use it to allocate the GMCSTARS data sets.

   1. From the TSO command line or ISPF option 6 FTP to the Linux machine that the gmcstars_xxx/mvs resides on.

      
      ftp my.linux.machine
      

      Specify your userid and password when prompted. Issue:

      
      cd gmcstars_nnn/mvs
      bin 
      locsite blk=3120 lrecl=80 recfm=fb 
      get install.xmit
      quit
      

      This will download the TSO transmit format install job to TSO.

   2. Receive the INSTALL.CNTL job by issuing:

      
      receive inda(install.xmit)
      

      The receive command will prompt you for receive parameters. Receive the installation job as member STARSINS into your standard CNTL data set. For example, to create a STARSIN member in your JCL.CNTL data set, respond to the prompt with:

      
      da(jcl.cntl(starsin))
      

   3. Edit STARSINS and modify it as needed. It will allocate the data sets GMCSTARS needs to install and run, including a large, empty data set for receiving load.xmit. TSO FTP does not allocate a large enough data set, by default.

   4. Modify the JOB card. If you will be using SMS to allocate the data sets, remove the UNIT and VOL portions of the DD cards. If you will be allocating to specific volume serial remove the SMS portions of the DD cards. Submit the STARSIN job and make sure it completes successfully.

Use the TSO FTP command to download gmcstars/mvs/load.xmit into the data set that was just preallocated. At this time you will also want to download gmcstars/mvs/parms.xmit, gmcstars/mvs/data.xmit and gmcstars/mvs/cntl.xmit.

1. From the TSO command line or ISPF option 6 FTP to the Linux machine that the gmcstars_xxx/mvs resides on.

   
   ftp my.linux.machine
   

   Specify your userid and password when prompted. issue:

   
   cd gmcstars_nnn/mvs
   bin 
   locsite blk=3120 lrecl=80 recfm=fb 
   get load.xmit (replace
   get parms.xmit
   get data.xmit
   get cntl.xmit
   quit
   

   This will download the TSO transmit format gmcstars installation files to your TSO userid.

2. Receive the LOAD.XMIT load library by issuing:

   
   receive inda(load.xmit)
   

   The receive command will prompt you for receive parameters. Receive the load library by specifying:

   
   ds(gmcstars-prefix.GMCSTARS.V1R0.LOAD)
   

3. Receive the PARMS.XMIT data set by issuing:

   
   receive inda(parms.xmit)
   

   The receive command will prompt you for receive parameters. Receive the parameters by specifying:

   
   ds(gmcstars-prefix.GMCSTARS.V1R0.PARMLIB)
   

4. Receive the DATA.XMIT data set by issuing:

   
   receive inda(data.xmit)
   

   The receive command will prompt you for receive parameters. Receive the data by specifying:

   
   ds(gmcstars-prefix.GMCSTARS.V1R0.DATA)
   

5. Receive the CNTL.XMIT data set by issuing:

   
   receive inda(cntl.xmit)
   

   The receive command will prompt you for receive parameters. Receive the GMCSTARS procedure by specifying any CNTL data set, for example:

   
   ds(JCL.CNTL)
   

Members of gmcstars-prefix.GMCSTARS.V1R0.PARMLIB contain the square bracket characters “[” and “]”. If you have trouble displaying or entering these characters, enter ISPF option 0, then set your Terminal Type to 3278A. If you are still having problems entering the characters, the hexadecimal equivalent for “[” is xAD and the hexadecimal equivalent for “]” is xBD. These can be entered into ISPF, by using the edit hex display feature.

Edit the MANAGERS member of gmcstars-prefix.GMCSTARS.V1R0.PARMLIB. A sample of the member is shown in MANAGERS Member of GMCSTARS PARMLIB.

You will need to replace the IP address of the managers, with those of the VCC servers in your installation.

	Note
	Make sure the VCC servers specified in the MANAGERS member are addressable from your MVS system.

#
#       Configuration file of SNMP managers(VCC Servers) - Traps are
#       sent to these hosts.
#
#    Copyright (c) 2004-2006 Global Maintech Corp.  All rights reserved.
#
#    THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
#    IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
#    WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
#       The format of this list is:
#       [server]
#       option=xxx
#       [server]
#       [server]
#
#       where:
#
#       server is the TCP/IP address of an VCC server to receive
#       traps from STARS.  The format of the manager TCP/IP address may
#       be a dotted IP address, a hostname or a fully qualified domain
#       name.
#
#       Each server section may have one or more options:
#
#       Port= is the optional trap port for the receiving machine.  The
#       default trap port is 162.
#
#       Community= is the SNMP community for this manager.  The default
#       community is "public".
#
#       Samples:
#       [vcc.globalmt.com]     # send traps to manager.globalmt.com
#       Port=20040             # at port 20040
#                              # community is public
#       [192.168.200.5]        # send traps to 192.168.200.5 on your
#                              # enterprise's network at port 162.
#       Community=private      # community is private
#
#
[192.168.0.19]
Port=2769
[192.168.0.11]
Port=2769
[egret]
Port=2769

Make gmcstars-prefix.GMCSTARS.V1R0.LOAD an APF authorized library.

1. To do this without IPLing MVS, issue the following operator command:

   
   SETPROG APF,ADD,LIBRARY=gmcstars-prefix.GMCSTARS.V1R0.LOAD,VOLUME=volume
   

   or if the load library is under SMS control, issue:

   
   SETPROG APF,ADD,LIBRARY=gmcstars-prefix.GMCSTARS.V1R0.LOAD,SMS
   

2. If you wish to make gmcstars-prefix.GMCSTARS.V1R0.LOAD a permanently authorized library, add the following lines to a PARMLIB PROGnn member.

   
   APF ADD
       DSNAME(gmcstars-prefix.GMCSTARS.V1R0.LOAD) VOLUME(volume)
   

   or if the library is under SMS control:

   
   APF ADD
       DSNAME(gmcstars-prefix.GMCSTARS.V1R0.LOAD) SMS
   

At this point you may wish to run GMCSTARS as a job, using the procedure you received earlier from CNTL.XMIT. Create a new job with a valid job card, the GMCSTARS procedure as a JCLLIB procedure and an EXEC card that invokes GMCSTARS.

//useridS JOB 'usrid',(acct,info),MSGCLASS=h,CLASS=c,NOTIFY=&SYSUID
// JCLLIB ORDER=(&SYSUID.JCL.CNTL)
//STARS EXEC GMCSTARS,
//  GMCPREF=gmcstars-prefix

Submit the job. The job should begin executing. Check the output to verify there are no error messages. If there are, correct them.

GMCSTARS will begin issuing SNMP traps to the VCC servers defined in the MANAGERS member.

To stop the GMCSTARS, issue: