Assembling the XCOMACF2 Security Module for XCOM for z/OS
search cancel

Assembling the XCOMACF2 Security Module for XCOM for z/OS

book

Article ID: 9409

calendar_today

Updated On:

Products

XCOM Data Transport XCOM Data Transport - z/OS

Issue/Introduction

When and how to Assemble the XCOMACF2 Security Module for XCOM™ Data Transport® for z/OS 12.0?

Assemble or relink the XCOMACF2 module as described below for r11.6 or r12.
However if have RO94308 Enhancement Support for Passphrase Security for 12.0 applied, then the new XCOMSEC Security module must be used instead as described in Additional Information below.

Environment

  • XCOM™ Data Transport® for z/OS 12.0
  • ACF2™

Resolution

All XCOM™ Data Transport® for z/OS installations using ACF2™ Security as their security interface must reassemble the ACF2™ Security module for XCOM for z/OS.

Member ASMACF2U in yourhlq.CBXGJCL provides an example of assembling and linking this ACF2™ Security module. This must be done doing a new install or upgrading XCOM in order to ensure that the required security is in place and working.

NOTE:
If there is an existing XCOMACF2 module that is already assembled and working with the current release of XCOM, and ACF2™ has just been upgraded to a newer release just a relink of that module is required. The yourhlq.CBXGJCL library contains a sample JCL procedure that can be used to link  XCOM Data Transport's ACF2™ interface module to the version of ACF2™ that is running. Edit yourhlq.CBXGJCL (LINKACF2) to fit your particular installation. Next, submit the edited procedure as a job. Be sure to check for any unresolved references in the linkage editor output.

Additional Information

XCOMSEC Security Module

If the r12 PTF RO94308 to enable passphrase support is applied, the XCOMSEC module performs all XCOM™ Data Transport® for z/OS security processing. XCOMSEC replaces XCOMACF2, XCOMTOPS and XCOMRACF.  No additional assembly or linking is necessary to run with the default CA XCOM security interface.

CAI.CBXGSAMP(XCOMSEC) contains the source code for the XCOM Security Interface. CAI.CBXGJCL(XCOMSEC) contains sample JCL that can be used to assemble and link edit it.

Follow these steps:

  1. (Optional) Customize XCOMSEC.
  2. Edit XCOMSEC to fit your installation standards and requirements. 
  3. Submit the edited procedure as a job. Check for any errors in the assembly or link edit job steps.

For information on using PASSWORD and LPASS with passphrase security, see XCOM Security Considerations