Starting the System

Instructions pertaining to accessing, starting, and using the Remote Development Program z/OS system are available online at

The links to the Setup Basics for IBM z/OS Remote Access Programs and User's Guide and Reference for IBM z/OS Remote Access Programs are located at the top right of the page and are applicable to all z/OS systems regardless of release level.

To avoid excessive work unit usage charges, please manage your system as documented in the section title Managing the guest z/OS with SLEEP and BEGIN in the User's Guide and Reference for IBM z/OS Remote Access Programs

User DASD Configuration

User DASD Configuration:

DASD volumes to use for your data:

VPWRKA (0D30) 3000 cyls
VPWRKB (0D31) 3000 cyls
VPWRKC (0D32) 3000 cyls
VPWRKD (0D33) 3000 cyls

CICS Instructions

CICS Transaction Server 6.1 Installation overview

The CICS system has been installed and configured according to instructions in the Program Directory and CICS Installation Guide. The DFHISTAR installation method was used. CICSPlex, Web User Interface and MVS Logger are not active.

To start CICSTS61 from the z/VM Control ID:

SEND ETPGyyy \CP VI VMSG start cicsts61,start=initial

To stop CICSTS61 from the z/VM Control ID:

SEND ETPGyyy \CP VI VMSG f cicsts61,'cemt p shut,imm'

The CICS startup procedure is kept in SVTSC.PROCLIB(CICSTS61).
The default DFHCSD definitions list is XYZLIST.
The VTAM APPLID is CICSTS61.

Installation and configuration JCL and samples for CICS TS Base are kept in dataset DFH610.SVSC.CUSTOM.INSTALL

Installation and configuration JCL and samples for CICSPlex SM and Web User Interface are kept in dataset DFH610.SVSC.CPSM.CUSTOM.INSTALL

Db2 13 Information and Instructions

The Reference Guide for Db2 on the z/OS Remote Access systems is available online at:

It is important to read this guide if you will be using Db2 on the remote z/OS system.

To start Db2 V13 from the z/VM Control ID:

SEND ETPGyyy \CP VI VMSG -DBDG START DB2

To stop Db2 V13 from the z/VM Control ID:

SEND ETPGyyy \CP VI VMSG F DBDGADMT,APPL=SHUTDOWN
SEND ETPGyyy \CP VI VMSG -DBDG STOP DB2

Subsystem Name (SSID): DBDG

Location: DALLASD

Port: 5045

TSO Logon Proc: DBPROCDG

IMS V15 Instructions and Information

The Reference guide for IMS and IMS Connect on the z/OS Remote Access systems is available online at

IMS maintenance is applied to all Remote Access systems on a monthly basis. It is your company's responsibility to complete any hold actions required for the installation of the maintenance.

Notifications regarding IMS maintenance will be sent to you. If these emails are not being received or if additional people need to be added to our IMS maintenance notification list, please send an email to etpadmin@us.ibm.com.

HLQ for IMS V15: DFSF10

To start IMS 15 from the z/VM Control ID:

First you will need to start IRLM for IMS 15 (If your entering the commands from the SDSF log you will need to put a "/" in front of the commands). The proc should match which ever version of IMS your starting.

SEND ETPGyyy \CP VI VMSG S IMS15RL1

You should see the following message in the SDSF log or on MVS console:

DXR117I IRLM001 INITIALIZATION COMPLETE

Next you will need to stat the IMS control region with the command shown below. Again, the proc should match which ever version of IMS your starting.

SEND ETPGyyy \CP VI VMSG S IMS15CR1

You should see the following message in the SDSF log or on MVS console: The message will show up as an outstanding message (the message should display white) .

*## DFS910A IMS READY (## will be some number)

You will need to reply to this message :

##,/NRE CHKPT 0 FORMAT ALL (this will cold start IMS)

OR

##,/NRE (this will warm start IMS)

You should see the following message in the SDSF log or on MVS console:

DFS994I COLD START COMPLETED.

OR

DFS994I WARM START COMPLETED.

Once IMS is started it will kick off a task to start the message processing regions. This will take a couple of minutes.

**NOTE If IMS requires an emergency restart you will need to look in the IMS V15 Operations Guide for examples.

To stop IMS 15 from the z/VM Control ID:

You will need to send the following message replys:

##,/NRE CHE SNAPQ (to checkpoint IMS)

Once IMS takes a checkpoint you can then stop IMS

##,/NRE CHE FREEZE (to stop IMS)

You should see the following message in the SDSF log or on MVS console:

$HASP395 IVPGNJCL ENDED - RC=0000

You can then terminate IRLM

SEND ETPGyyy \CP VI VMSG P IMS15RL1 (to terminate IRLM)

IBM MQ 9.2.0 Instructions

To start queue manager CSQ9 from the z/VM Control ID:

SEND ETPGyyy \CP VI VMSG %CSQ9 START QMGR
SEND ETPGyyy \CP VI VMSG %CSQ9 START CHINIT

To stop queue manager CSQ9 from the z/VM Control ID:

SEND ETPGyyy \CP VI VMSG %CSQ9 STOP CHINIT
SEND ETPGyyy \CP VI VMSG %CSQ9 STOP QMGR

WebSphere Application Server for z Systems V9R0

Application Development Foundation for z/OS V4.0

The Application Delivery Foundation for z/OS V4.0 product has been installed on your z/OS RDP system.

The product volumes are :

  • VTISMH (1D2E)
  • VDISMH (1D2F)
  • VPISMH (1D30)

The HLQ is : ISM402

Additional product and usage information can be located in dataset ISM402.SVSC.README(XINSTALL) and ISM402.SVSC.README(PRODUCT)on volume VDISMH. The products listed below are installed with Application Delivery Foundation for z/OS V4.0:

  • z/OS Explorer Extensions G00
  • Explorer for z/OS 330
  • File Manager Base F10
  • File Manager Db2 F12
  • File Manager IMS F14
  • File Manager CICS F16
  • ADFzCC -- Base 190
  • z/OS Source Code Analysis G00
  • Application Performance Analyzer F10
  • Rocket Git for z/OS 111
  • IBM Dependency Based Build 200
  • z/OS Dynamic Test Runner 100
  • IBM Z Open Automation Utilities 120
  • RSE API 110
  • z/OS Debugger Base G00
  • Fault Analyzer F10
  • Wazi Deploy 300

Configuration files on VPISMH :

  • ISM402.SVSC.CONFIG.BGY
  • ISM402.SVSC.CONFIG.BZU
  • ISM402.SVSC.CONFIG.CAZ
  • ISM402.SVSC.CONFIG.DBB
  • ISM402.SVSC.CONFIG.EQA
  • ISM402.SVSC.CONFIG.FMN
  • ISM402.SVSC.CONFIG.HUH
  • ISM402.SVSC.CONFIG.IDZ

CICS Transaction Gateway 9.3.0

The host product code of CICS Transaction Gateway 9.3.0 has been made available to your system. In order to use the product you will need to customize and configure it. The high-level qualifier for the product datasets is CTG930. Additional installation information is located in dataset CTG930.SVSC.README(XINSTALL).

z/OS Connect EE Unlimited 3.0 Installation Information

The z/OS Connect EE 3.0 Unlimited product has been included in your ETPxxxx system.

The product volumes are :

  • VTBAQC (19AF)
  • VDBAQC (19B0)
  • VPBAQC (19B1)

The HLQ is : BAQ30E

The z/OS Connect file systems.

 MOUNT FILESYSTEM('BAQ30E.BASE.ZFS')
       TYPE(ZFS)
       MODE(READ)
       MOUNTPOINT('/usr/lpp/IBM/zosconnect')

 MOUNT FILESYSTEM('BAQ30E.REL.ZFS')
         TYPE(ZFS)
         MODE(READ)
         MOUNTPOINT('/usr/lpp/IBM/zosconnect/v3r0')

 

Additional product information can be located in dataset BAQ30E.SVSC.README(XINSTALL) and BAQ30E.SVSC.CONFIG on volume VDBAQC.

Technical Support

Technical Support is provided via e-mail. Hours of attended operation are 07:00 to 19:00 US Central time Monday through Friday except IBM USA holidays. Emails received after hours, on weekends, or on holidays will be processed the next business day. If you require technical support, please follow the instructions on https://dtsc.dfw.ibm.com/contact

System Backups

IBM performs backups of the virtual guest systems on a regular (weekly) basis and the media used for the backups are stored on-site, only. Included in these backups are the data disks which together comprise the guest systems. The purpose of the backup is to provide a level of opportunity for the recovery of data in the event of a catastrophic disk failure. The backups may also be used to recover data for a guest system though, due to unforeseen circumstances, there is no assurance that recovery of data for a guest system will be successful. IBM encourages all program participants to regularly save a copy of their data to a location of their choosing. The data stored at the IBM ISV Center should never be the only copy of the data.

The techniques used for saving data will vary depending on the guest operating system in use and are discussed in the User's Guide and Reference applicable to your guest operating system under "Support Documents" on the https://dtsc.dfw.ibm.com/public website.

Program Termination

Your enrollment in the IBM Z Remote Development Program (RDP) will not automatically terminate. You may choose to terminate your enrollment in the RDP at any time by providing IBM written notice at least thirty (30) days prior to the effective date of the termination. The effective date will be the last day of the calendar month to coincide with the end of the of the monthly invoice cycle.

Additional Maintenance and Subsystem Information

The IBM Z ISV Development Programs provides maintenance for operating systems, subsystems and products on a frequent basis. Additional instructions about required maintenance tasks and other releases of products can be found on the following page:

Optional VPN Feature Information

The following information is for ISVs that requested the VPN Feature for their system under the IBM Z Remote Development Program.

Before logging in to the remote system, a connection to the VPN must be established. This is done by using the Cisco Secure Client (formerly AnyConnect).

An option to download the Cisco Secure Client will be provided. It is only available to enable a connection to the assigned IBM machine that's part of this program offering. When the remote access is terminated, the license to use the Cisco Secure Client will expire and the client must be removed from the system(s).

Instructions for accessing the Cisco Secure Client are available on our Secure Website: https://dtsc.dfw.ibm.com

  • A pop-up window will appear, requesting a Username and Password.
  • Use the assigned z/VM User ID that was provided in a separate email. The user ID will be in this format - ETPDyyy.
  • After logging in, proceed to the "Secure Information Center" section and click on "Remote VPN Client Access".

After the VPN connection has been established, connect to the remote system with a TN3270 emulator for z/OS, using the guest system IP address identified in the delivery email.