gtpm1m0jTPF V4R1 Migration Guide: 3.1 to 4.1

General and System Macros

Starting with the TPF 4.1 system, there are separate publications for general and system macros, rather than one publication as was provided with the TPF 3.1 system:

In addition, invocation of macro parameters is described using IBM BookMaster syntax diagrams.

General Macros

Table 7 summarizes the general macro changes for the TPF 4.1 system.

Table 7. Changes to General Macros for the TPF 4.1 System

General Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
ASURC No Longer Supported Not Applicable
ATTAC Changed No (See Note 1.)
BACKC Changed No
BEGIN Changed No
BPKDC Changed Yes
CALOC New Not Applicable
CCIDC Changed No
CFISVC New Yes (See Note 5.)
CINFC Changed No
CONKC Changed No
CRATC Changed No (See Note 1.)
CREDC Changed No
CREEC Changed No
CREMC Changed No
CRESVC New Yes (See Note 5.)
CRETC Changed No
CREXC Changed No
CTBLC No Longer Supported Not Applicable
CVTPC New Not Applicable
CYCPC Changed Yes (See Note 2.)
DETAC Changed No (See Note 1.)
DPROC Changed No (See Note 1.)
EDITA Changed No
ENTDC Changed No
ENTNC Changed No
ENTRC Changed No
FILKW Changed No
FINIS Changed No
FLIPC Changed No (See Note 1.)
FREEC New Not Applicable
GDSPC Changed No
GENMSG Changed No
GETCC Changed No
GETFC Changed No
GLOUC Changed No
GROUP Changed Yes
ICELOG Changed No
ICLANC Changed No
ICPLOG Changed No
IDATG New Not Applicable
IFRVTC New Not Applicable
IFSMC Changed Yes
INQRC Changed Yes
ISNSE Changed Yes
LINEQ Changed Yes
LISTC Changed No
LSTSC No Longer Supported Not Applicable
MALOC New Yes
MODEC Changed No (See Note 1.)
NTYPC No Longer Supported No
PNAMC Changed Not Applicable
POLLC No Longer Supported Not Applicable
RALOC New Not Applicable
RCATC Changed No (See Note 4.)
REQSC No Longer Supported Not Applicable
RIDCC Changed Yes
RTCUC Changed No (See Note 1.)
RVTCC Changed No (See Note 1.)
SANSC No Longer Supported Not Applicable
SCDCC No Longer Supported Not Applicable
SELEC Changed Yes
SEOMC No Longer Supported Not Applicable
SIZBC Changed Yes
SNAPC Changed Yes
SNIAC No Longer Supported Not Applicable
SONIC Changed No (See Note 1.)
STXTC No Longer Supported No
SWISC Changed No
SYSRA Changed No
SYSTC Changed Yes
TCLSC Changed No
TCTLC No Longer Supported Not Applicable
TDSPC Changed No
TIMEC Changed No (See Note 1.)
TOURC Changed No (See Note 3.)
TOUTC Changed No (See Note 3.)
TSYNC Changed No
TYPBC Changed Yes
UATBC Changed No (See Note 1.)
URCTC Changed No
VALTC Changed Yes
WTOPC Changed No
Notes:
  1. If the segment that contains this macro is not reassembled, then the segment must be allocated as 24-bit.
  2. The CYCPC macro generates a CROSC macro if the default values are used. Programs that use the CROSC macro require restricted macro authorization unless a specific parameter is coded.
  3. If you are running TPF 3.1 object code on the TPF 4.1 system, any segments using the TOURC and TOUTC macros must be reloaded since the VCON for the real-time tape is now resolved at macro time.
  4. The RCATC macro is not compatible between the TPF 3.1 system and the TPF 4.1 system and must be recreated due to the RCATSWIS field (the SWISC enter expansion).
  5. All user segments using the CFISVC and CRESVC macros should be reassembled.

System Macros

Table 8 summarizes the system macro changes for the TPF 4.1 system. System macros fall into these categories:


Table 8. Changes to System Macros for the TPF 4.1 System

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
#SBRC Changed No
$CCWBC New Not Applicable
$CCWTC New Not Applicable
$CKMAC New Not Applicable
$CONBC New Not Applicable
$DCOLC New Not Applicable
$DISBC New Not Applicable
$GCOMC New Not Applicable
$GETBC New Not Applicable
$GEVAC New Not Applicable
$GIOBC New Not Applicable
$GMNBC New Not Applicable
$GSVAC New Not Applicable
$GSWBC New Not Applicable
$LOCKC Changed Not Applicable (See Note 1.)
$MASKC New Not Applicable
$MONTC Changed Yes
$PATC New Not Applicable
$RCOMC New Not Applicable
$RECVC New Not applicable
$RELBC New Not Applicable
$RIOBC New Not Applicable
$RMNBC New Not Applicable
$RSWBC New Not Applicable
$SWSPC New Not Applicable
$TCPLC New Not Applicable
$UNLKC Changed Some (See Note 2.)
$VALEC New Not Applicable
ADDFC Changed No
ADDLC Changed No
ASURC No Longer Supported Not Applicable
ATOLC No Longer Supported Not Applicable
BBWRT Changed Yes
BLKBC No Longer Supported Not Applicable
BRSTR Changed Yes
BSAVE Changed Yes
BSCQC New Not Applicable
CEBIC Changed Some (See Note 3.)
CIOUC Changed No
CLHCC No Longer Supported Not Applicable
CLHEC No Longer Supported Not Applicable
CLNKC Changed No
CPDSC Changed Yes
CPRND Changed No
CROSC Changed Yes
CTBLC No Longer Supported Not Applicable
CWRTC Changed Yes
CXFRC Changed Yes
CYDNC New Not Applicable
CZ1CP Changed No
DSDAC Changed No
ELLEC Changed Yes
ESFAC New No Applicable
FACZC New Not Applicable
FCTLC Changed Yes
FDCTC Changed No
FLFAC Changed Yes
FLSPC Changed Yes (See Note 7.)
FLVFC New No
FNSPC Changed Yes (See Note 7.)
GDSCC Changed Yes
GETBC No Longer Supported Not Applicable
GETPC Changed Yes
GIOBC No Longer Supported Not Applicable
GSVAC New Not Applicable
GTMBC No Longer Supported Not Applicable
HIOSC Changed No
IBMSVC New Not Applicable
ICALL Changed No
IGATC Changed No (See Note 4.)
ILCKCB Changed Yes
IPSVE Changed Yes
IPURGE Changed Yes
ISDAC Changed No
IULKCB Changed Yes
LCPCC New Not Applicable
LEBIC Changed Yes
LSTSC No Longer Supported Not Applicable
MATRC No Longer Supported Not Applicable
MAXBC Changed Yes
MONWC Changed Not Applicable
MOVEC New Not Applicable
MPIFC Changed Yes
MSDAC Changed No
MSGMC Changed Yes
NUMBC Changed Yes
NXTBC No Longer Supported Not Applicable
NXTPC Changed No
NXTRC New Not Applicable
ORDBC No Longer Supported Not Applicable
PERCC New Not Applicable
PHYBC Changed Yes
PKEYC Changed Yes
PLNAC Changed Yes
PMOCN Changed Yes
POLLC No Longer Supported Not Applicable
PROGC New Not Applicable
RCSSC Changed No
RCSTC Changed Yes
RELBC No Longer Supported Not Applicable
RELPC Changed Yes
REQSC No Longer Supported Not Applicable
RESMC Changed No
RIOBC No Longer Supported Not Applicable
RIOSC Changed No
RITID Changed Yes
RLMBC No Longer Supported Not Applicable
RLNKC Changed No
SANSC No Longer Supported Not Applicable
SCDCC No Longer Supported Not Applicable
SENDC Changed Some (See Note 5.)
SERRC Changed Some (See Note 6.)
SETDC No Longer Supported Not Applicable
SICFC New Not Applicable
SIOSC Changed No
SIPCC Changed Yes
SLCQC New Not Applicable
SLNKC Changed No
SNDLC Changed No
SOUTC Changed Yes
STPLC No Longer Supported Not Applicable
STTLC No Longer Supported Not Applicable
STXTC No Longer Supported Not Applicable
SWCHC Changed No
TCTLC No Longer Supported Not Applicable
TDCTC Changed No
TDTAC Changed No
TIOSC Changed No
TPCNC Changed No
TPINC Changed No
UXITC Changed Yes
VALBC Changed Yes
WTO6C Changed No
WTO7C Changed No
Notes:
  1. Segments coding the IMMED= parameter must be reassembled.
  2. Segments coding the FORCE= parameter must be reassembled.
  3. Only CP code needs to be reassembled.
  4. If the segment that contains this macro is not reassembled, then the segment must be allocated as 24-bit.
  5. Type S support was removed.
  6. The MD and CLIST parameters are no longer supported.
  7. The FNSPC and FLSPC macros are only supported when using the Extended option. If a FNSPC or a FLSPC macro is issued without the Extended option, the TPF 4.1 system issues a CTL-00002D dump and exits the ECB.

Information-Only Macros

Table 9 summarizes the information-only macro changes for the TPF 4.1 system.

Table 9. Changes to Information-Only Macros for the TPF 4.1 System

Information-Only Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CLHCC No Longer Supported Not Applicable
CLHEC No Longer Supported Not Applicable
SSCCP Changed Yes

Structured Programming Macros (SPMs)

Table 10 summarizes the structured programming macro (SPM) changes for the TPF 4.1 system. See TPFDF and TPF Structured Programming Macros for a complete description of all structured programming macros.

Table 10. Changes to Structured Programming Macros (SPMs) for the TPF 4.1 System

Structured Programming Macro (SPM) New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
WHEN Changed No

Structured Programming Macros (SPMs) (IBM Use Only)

Table 11 summarizes the structured programming macro (SPM) (IBM use only) changes for the TPF 4.1 system.

Table 11. Changes to Structured Programming Macros (SPMs) (IBM Use Only) for the TPF 4.1 System

Structured Programming Macro (SPM) (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
WKRGC Changed No

Selected Equate Macros

Table 12 summarizes the selected equate macro changes for the TPF 4.1 system.

Table 12. Changes to Selected Equate Macros for the TPF 4.1 System

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
BRPEQ Changed Yes
CAIEQ Changed No
CLHEQ Changed Yes
CPSEQ Changed No
CVMEQ No Longer Supported Not Applicable
C20CP Changed Yes
ECBEQ Changed Some (See Note 1.)
ECBUEQ No Longer Supported Not Applicable
FILMEQ No Longer Supported Not Applicable
IBXEQ New Not Applicable
LINEQ Changed Yes
LOCEQ Changed Yes
MAPEQ Changed No
NODEQ Changed Yes
OMTEQ Changed No
PIUEQ Changed Yes
PTVEQ Changed Yes
REGEQ1 Changed No
RITEQ Changed Yes
RTCEQ Changed No
RTTEQ Changed Yes
SNAEQ Changed Yes
SYCON Changed Yes
SYSEQ Changed Yes
TAPEQ Changed Yes
TPLEQ No Longer Supported Not Applicable
TRMEQ Changed Yes
Notes:
  1. Fields between CE1GPC and the end of the program nesting levels were manipulated. Further investigation of your source code is necessary to determine which modifications and reassemblies are required.