PJ46793: Support for IBM Copy Services Manager REST APIs

APAR status

• Closed as new function.

Error description

• See Problem Summary.
  

Local fix

Problem summary

• APAR NUMBER:  PJ46793
  PRODUCT:  z/TPF
  FUNCTIONAL AREA:  DASD External Copy Services
  SHIPPED IN YEAR:  2022
  
  ABSTRACT:
  Support for IBM Copy Services Manager REST APIs
  
  PACKAGE CONTENTS:
  Source Segments:
  (C) base/cntl/tpf.loadfile
  (C) base/cntl/tpf_app_base.cntl
  (C) base/include/tpf/c_syseq.h
  (N) base/include/tpf/c_tpfcsm.hpp
  (N) base/include/tpf/i_zcpys.hpp
  (C) base/macro/syseq.mac
  (N) base/rt/csmc.cpp
  (N) base/rt/csmc.mak
  (N) base/rt/csml.cpp
  (N) base/rt/csml.mak
  (C) base/rt/cvaa.mak
  (C) base/rt/cvab.asm
  (C) base/rt/cvau.asm
  (N) base/tpf-fdes/tpfcsm.lib.dfdl.xsd
  
  Object Only Binaries:
  None.
  
  BINARIES TO BUILD: YES
  Configuration Independent Binaries:
  (N) base/lib/libCSML.so
  (N) base/load/CSMC.so
  (N) base/load/CSML.so
  (C) base/load/CVAA.so
  (N) base/obj/csmc.o
  (N) base/obj/csml.o
  (C) base/obj/cvau.o
  
  Configuration Dependent Binaries:
  (C) <sys>/load/CVAB.so
  (C) <sys>/obj/cvab.o
  (C) os390/bin/bmgl.pds
  (C) os390/bin/chqi.pds
  (C) os390/bin/ppcp.pds
  (C) os390/bin/stc.pds
  (C) os390/obj/bmgl.o
  (C) os390/obj/ccmcdc.o
  (C) os390/obj/chqi.o
  (C) os390/obj/dgr0.o
  (C) os390/obj/stcc.o
  (C) os390/obj/stpp.o
  (C) <sys>/load/IPAT.so
  (C) <sys>/obj/ipat.o
  
  
  COMMENTS:
  Support for IBM Copy Services Manager REST APIs
  

Problem conclusion

• SOLUTION:
  The z/TPF support for the IBM Copy Services Manager REST APIs
  provides the ability to manage or query certain copy service
  capabilities on a Copy Service Manager management server from
  the TPF console. The new ZCPYS console command is used to
  establish server connectivity and send requests through the
  Copy Services Manager REST APIs. The initial support includes
  retrieving the summary of all Safeguarded Copy sessions or the
  details of a particular Safeguarded Copy session, and starting
  a Backup action on a Safeguaded Copy session. The support also
  has the option to ensure that a Copy Services Manager is the
  active server of a synchronized high-availability environment
  before sending a request to start a copy service operation.
  
  COREQS: NO
  None.
  
  MIGRATION CONSIDERATIONS: YES
  Functional, automation, and operation changes:
  New command:
  ZCPYS
  
  New online messages:
  CPYS0001I
  CPYS0002I
  CPYS0003I
  CPYS0004I
  CPYS0005I
  CPYS0006I
  CPYS0007I
  CPYS0008I
  CPYS0009I
  CPYS0010I
  CPYS0100E
  CPYS0101E
  CPYS0102E
  CPYS0103E
  CPYS0104E
  CPYS0105E
  CPYS0106E
  CPYS0107E
  CPYS0108E
  CPYS0109E
  CPYS0110E
  CPYS0111E
  CPYS0112E
  CPYS0113E
  CPYS0114E
  CPYS0115E
  CPYS0116E
  CPYS0117E
  CPYS0118E
  CPYS0119E
  CPYS0120E
  
  Hardware, software, and configuration changes:
  The Copy Services Manager must be version 6.3.2 or higher to be
  sent a request from this support.
  
  The ICSMRST encryption key name must be generated and activated
  with the ZKEYS console command before a Copy Services Manager
  server profile can be registered.
  
  An enhanced HTTP client configuration file for TLS must be
  defined to allow the z/TPF system to establish a secure
  connection to the Copy Services Manager using the HTTPS
  protocol.
  
  Database changes:
  The z/TPF support for Copy Services Manager uses the ordinal
  number 196 (0xC4) for the #IBMM4 record type and record ID FC99
  for its internal control record.
  
  
  
  BUILD COMMANDS AND INSTRUCTIONS: YES
  #maketpf commands for linux
  maketpf -f CVAA cvau.o
  maketpf -f CVAB cvab.o
  maketpf -f CSML csml.o
  maketpf -f CSMC csmc.o
  maketpf -f IPAT
  maketpf CVAA link TPF_VERIFY_LINK_REFS=NO
  maketpf CVAB link
  maketpf CSML link
  maketpf CSMC link
  maketpf CVAA link
  #maketpf commands for z/OS
  maketpf -f bmgl bmgl.o
  maketpf -f chqi chqi.o
  maketpf -f ppcp ccmcdc.o stpp.o
  maketpf -f stc dgr0.o stcc.o
  maketpf bmgl link
  maketpf chqi link
  maketpf ppcp link
  maketpf stc link
  
  UPDATED INFORMATION UNITS: YES
  z/TPF and z/TPFDF Migration Guide: PUT 2 and Later
  z/TPF Database User's Guide
  z/TPF Messages (Online, SQLCODEs, and errno Values)
  z/TPF Operations
  
  See your IBM representative if you need additional information.
  
  DOWNLOAD INSTRUCTIONS:
  https://www.ibm.com/support/docview.wss?uid=swg27049604
  
  APAR URL:
  https://transfer.boulder.ibm.com/2022/PJ46793.tar.gz
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  Z/TPF

• Fixed component ID

  5748T1501

Applicable component levels