z/OS ISPF Software Configuration and Library Manager Guide and Reference
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS ISPF Software Configuration and Library Manager Guide and Reference
SC19-3625-00
First Edition (September 2013)
Abstract for Software Configuration and Library Manager (SCLM) Guide and Reference
Where to find more information
Project Manager's Guide
Defining the project environment
Running different versions of SCLM in multiple partitions
Overview of project manager tasks
Project definition data
Generating a project environment
Step 1: Determine the project's hierarchy
Primary non-key group testing techniques
Step 2: Identify the types of data to support
Step 3: Establish authorization codes
Using authorization codes to control SCLM operations
Allowing parallel updates
Step 4: Allocate the PROJDEFS data sets
Step 5: Allocate the project partitioned data sets
Data set naming conventions
Flexible naming of project partitioned data sets
Number of data sets to allocate
Determining when data set allocation is necessary
How SCLM functions use data sets
Manipulating VSAM records for unallocated data sets
Examples of hierarchies with unallocated data sets
Versioning partitioned data sets
Project partitioned data sets
Space considerations
Step 6: Allocate and create the control data sets
Create the accounting data sets
Space considerations for the accounting data sets
Create the export data sets
Create the audit control data sets
Space considerations for the audit data sets
Create the Cross-dependency data set
Creating the SCLM control data set
Step 7: Protect the project environment
PROJDEFS data sets
Project partitioned data sets
Control data sets
Step 8: Create the project definition
Alternate project definitions
Create the hierarchy definition
Specify the project name with FLMABEG
Define authorization groups with FLMAGRP
Define types with FLMTYPE
Define groups with FLMGROUP
End the definition with FLMAEND
Set the project control options
Primary accounting data set specification
Secondary accounting data set specification
Export accounting data set specification
Audit control data sets specification
Cross-dependency data set specification
Cross-dependency data set dynamic update specification
VSAM Record Level Sharing (RLS)
Versioning partitioned data sets specification
Project partitioned data set naming conventions
Maximum lines per page
Number of versions to keep
Translator option override
Member level locking
SCLM temporary data set allocations
User exit routine specification
Example project definition
Define the language definitions
Modifying example language definitions
Step 9: Assemble and link the project definition
Assemble and link example
Project manager scenario
Prerequisites for defining an SCLM project
Example project overview
Preparing the example project hierarchy
Understanding the sample project definition
Preparing the example project data
User exits
Specify the change code verification routine
Change code verification routine example
Specify the Build and Promote User Exit routines
Build and Promote User Exit routine requirements
Build and Promote User Exit output data sets
Specify the Audit Version Delete User Exit routine
Audit Version Delete User Exit routine requirements
Specify the Delete User Exit routine
Delete User Exit Routine requirements
Delete User Exit output data set
User exit routine example
Additional project manager tasks
Splitting project VSAM data sets
Backing up and recovering the project environment
Synchronizing accounting data sets
Maintaining accounting data sets
Modifying the Delete from Group dialog interface
Implementing package backout
Converting projects to SCLM
Prerequisites for existing hierarchies
Create alternate project definitions
Create architecture definitions for the project
Register existing PDS members with SCLM
Introducing fixes to the converted hierarchy
Language definition considerations
Using multiple translators in a language definition
Invoking user-defined parsers
Defining information tracked by SCLM
Writing the parser
Telling SCLM how to invoke your parser
Processing conditionally saved components
Example of processing conditionally saved components
Setting up the project definition
Specifying the locations of included members
Example
Dynamic include tracking
Input list translators
Configuring the input list translators
Defining a new language to SCLM
Using DDnames and DDname substitution lists
Compiler options
Defining a new language: step-by-step
Showing users how to write CC architecture definitions
Convert your JCL decks to architecture definitions
Defining a preprocessor to SCLM
Passing the source to the compiler
Converting JCL to SCLM language definitions
Before you begin
Capabilities and restrictions
Converting JCL cards to SCLM macro statements
Executing programs
Conditional execution
Sample JCL conversion
Using SCLM and Tivoli Information Management for z/OS
Required environment
Description of user program interaction
Input parameters
Option list format
Information Management parameters
SCLM parameters
Program flow
Error processing
Example
Understanding and using the customizable parsers
The parsers as provided
Sample language definitions
Parser error listings
Modifying the parsers
Adding more elaborate parsing error messages
Appending to the error listing file
Compiling the parsers
Developer's Guide
The Software Configuration and Library Manager
SCLM project environment
User application data
SCLM hierarchies
Key/non-key groups
Moving data through the hierarchy
Using SCLM functions
Name retrieval with the NRETRIEV command
SCLM considerations for NRETRIEV
SCLM restrictions
Stack management for SCLM
SCLM main menu
SCLM main menu options
SCLM main menu action bar choices
SCLM main menu panel fields
View (option 1)
SCLM View - Entry Panel action bar choices
Reflist
Refmode
SCLM
SCLM View - Entry Panel fields
Edit (option 2)
SCLM Edit - Entry Panel fields
Comparison of SCLM and ISPF editors
SCLM command macros
EDIT command
SAVE command
SCOMPARE command
SCOPY command
SCREATE command
SMOVE command
SPROF command
SCLM Edit Profile Panel fields
SREPLACE command
Overriding SCLM command macros
Utilities (option 3)
Library Utility
Library Utility commands
Member selection list
Accounting record
Statistics
Change code list
Include list
User data entries
Build map record
Build map contents
Authorization code update
Transfer ownership
Where-used
Change Promote Processing (NOPROM)
Migration Utility
Database Contents Utility
Specifying selection criteria
Accounting information fields
Hierarchy search information
Tailored output
Tailored output examples
Change Code Report
Accounting Statistics Report
Source Listing Report
Cleanup Report
Architecture Report Utility
Architecture Report example
Export Utility
Export Report example
Import Utility
Import Report example
Audit and Version Utility
SCLM Version Selection
SCLM Audit and Version Record
SCLM Version Compare
External Compare
Retrieve
Delete from Group Utility
Delete from Group Report example
Package Backout Utility
Backup phase
Restore phase
Package functions
Package Member Details
Unit of Work Utility
Unit of Work options
SCLM Unit of Work Data Set Specification panel
Define Unit of Work list commands
UOW Member List panel
Work Element List panel
SCLM Explorer
FLMUEXTR—the SCLM Explorer batch utility
SCLM Search
Specifying additional search strings
Search-For strings and keywords
Entering search strings
Using keywords
SCLM Search member lists
SCLM Search example
Build (option 4)
Build Report example
Build Information Example
Promote (option 5)
Promote Report
Processing errors
Data set overflow
Data contention
Command (option 6)
Easy Cmds (option 6A)
Batch Processing
Output disposition
Sample Project Utility (option 7)
Maintaining SCLM administrators (option A)
Development scenario
Understanding the hierarchy and the SCLM main menu
Understanding the architecture definition
Sample SCLM development cycle
Using the SCLM editor
Understanding the library utility
Using Build
Editing the member to correct errors
Attempting to promote a member before performing a build
Rebuilding the changed member
Using the Database Contents Utility
Promoting a member successfully
Drawing down a promoted member
Performing project housekeeping activities
Architecture definition
Architecture members
Kinds of architecture members
Defining compiler processed components
Compilation control architecture members
Specifying source members
Defining link-edit processed components
SCLM build and control timestamps
Defining application and subapplication components
Generic architecture members
Build and promote by change code
Architecture statements
Statement format
Statement uses
Sample application using architecture definitions
Ensuring synchronization with architecture definitions
Build outputs
Multiple build outputs
Sequential build outputs
Default output member names
Languages of output members
Advanced Topics
Managing complex projects
Impact assessment techniques
Dependency processing
Propagating applications to other databases
SCLM support for DB2
Restrictions
Information for project administrators
The FLMCSPDB DB2 bind/free translator
Generating a project environment
Step 1: Determine the project's hierarchy
Step 2: Identify the types of data to be supported
Step 3: Establish authorization codes
Step 4: Allocate the PROJDEFS data sets
Step 5: Allocate the project partitioned data sets
Step 6: Allocate and create the control data sets
Step 7: Protect the project environment
Step 8: Create the project definition
Define the language definitions
Step 9: Assemble and link the project definition
Information for developers
Getting started
Create a program that has SQL statements
Create a generic architecture definition to control the bind
Create a high-level (HL) architecture definition to link link-edit to bind
Alternative High Level (HL) architecture definition to link link-edit to bind
Other architecture definition considerations
Create DB2 CLIST
More complex scenarios
Storing bind options in a bind control file
Binding on different LPARs
Rebinding at lower levels after a promotion
SCLM support for workstation builds
Requirements
Overview of workstation build
Information for the project manager
Naming conventions
Languages
What workstation tools will you use?
What parameters do you need for the workstation tools?
Workstation information
More information on SCLM, ISPF, and workstation builds
ISPF Sample and Macro libraries
Information for the developer
Migrating applications into SCLM
Architecture definition members for workstation applications
Specifying options
Including outputs from other build steps
Running multiple workstation commands
Sample language definition
Workstation setup
Directories and file names
Multiple builds on one workstation
Leaving a Member Behind on Promotion
Setting a member as not being promotable
Using the N line command in Library Utilities (option 3.1) or Unit of Work (option 3.11)
FLMCMD NOPROM service
FLMLNK NOPROM service
Process of not promoting a member (REBUILD)
Process of not promoting a member (NOREBUILD)
SCLM project setup when promoting with no rebuilding of build maps
Build containing a non-promotable member (NOREBUILD)
Promote containing a non-promotable member (NOREBUILD) from the same level containing the NOPROM member
Viewing the non-promoted backup member
Promote containing a non-promotable member (NOREBUILD) from a level not containing the NOPROM member
Build containing a non-promotable member (NOREBUILD) at a level which does not contain the NOPROM member
Build after promotion of the non-promotable member (NOREBUILD)
Restricting the setting of non-promotable
Examples
Member encoding and decoding
Setting up encoding and decoding
Removing encoding and decoding
SCLM security
SCLM internal security
Enabling security
Determining the type of security to implement
Setting up SCLM DSN security
Setting up SCLM subproject security
Setting up SCLM service security
Working with subproject security
Migrating members into SCLM subproject security
Viewing the subproject members
Resolving authority problems
SCLM Reference
Invoking the SCLM services
Invoking the SCLM services
Command invocation of the SCLM services
The FLMCMD interface
FLMCMD parameter conventions
Using command invocation variables
Using the FLMCMD file format
Performance considerations
Command data set conventions
Interactive command processing
Call invocation of the SCLM services
The FLMLNK subroutine interface
FLMLNK parameter conventions
FORTRAN, Pascal, and C
FORTRAN example
Pascal example
C example
PL/I
PL/I example
COBOL
COBOL example
Selecting a service from the FLMCMD Services Menu
Automatic allocation of output data sets
Entering a command to invoke a specific service panel
Types of parameters
DDNAME parameters
Character parameters
Selection parameters
Pointer parameters
Pointer parameter descriptions
$msg_array
$acct_info
$stats_info
$list_info
ISPF variables
SCLM service return codes
FLMCMD command processor return codes
FLMLNK call processor return codes
SCLM service messages
SCLM services
SCLM service descriptions
ACCTINFO—Retrieve Accounting Information
AUTHCODE—Retrieve or Set Authorization Code for Selected Members
BUILD—Build a Member
CCEXITS—Run User Exits without Edit
DBACCT—Retrieve Accounting Records for a Member
DBUTIL—Generate a Tailored Output Data Set and Report
DELETE—Delete Database Components
DELGROUP—Delete from Group Database Components
DSALLOC—Allocate Data Sets for Group/Type
EDIT— Edit a Member of a Controlled Library
END— End an SCLM Services Session
ENDEC— Encode and Decode members
EXPORT—Extract SCLM Accounting Information for a Group
FREE—Free an SCLM ID
GETBLDMP—Retrieve Build Map Information
GETXDEP—return cross-dependency information
IMPORT—Import SCLM Accounting Information to Current Project
INIT—Generate an SCLM ID
LOCK—Lock a Member or Assign an Access Key
MIGRATE—Create Accounting for Selected Members
NEXTGRP— Retrieve the Next Group in an SCLM Hierarchy
NOPROM—Change Promote Processing
PARSE—Parse a Member for Statistical and Dependency Information
PROMOTE—Promote a Member from One Library to Another
RPTARCH—Generate an SCLM Architecture Report
SAVE—Lock, Parse, and Store a Member
SCLMINFO—Return Project Information
START—Generate an Application ID for a Services Session
STORE—Store Member Information in an Accounting Record
UNLOCK—Unlock a Member in a Development Library
VERDEL—Delete Version and Audit Information
VERINFO—Retrieve Version and Audit Information
VERRECOV—Recover a Version
XDEPUPDT—Update Cross-dependency Information
Sample programs using SCLM services
Pascal example
Main program FLMSRV1
Included member FLMSRV1D
Included member FLMSRV1S
PL/I example
SCLM macros
Notes on using the SCLM macros
Using SCLM variables in SCLM macros
FLMABEG macro
FLMAEND macro
FLMAGRP macro
FLMALLOC macro
FLMALTC macro
FLMATVER macro
FLMCNTRL macro
FLMCPYLB macro
FLMGROUP macro
FLMINCLS macro
FLMLANGL macro
FLMLRBLD macro
FLMPROJ macro
FLMNPROM macro
FLMSYSLB macro
FLMTCOND macro
FLMTOPTS macro
FLMTRNSL macro
FLMTYPE macro
SCLM translators
FLMCSPDB DB2 Bind/Free translator
0
FLMDTLC DTL Processor Build translator
0
FLMLPCBL COBOL Parser
0
FLMLPFRT FORTRAN Parser
0
FLMLPGEN General Purpose Parser
0
FLMLRASM REXX Assembler Parser
0
FLMLRCBL REXX COBOL Parser
0
FLMLRCIS MVS C/C++ parser with include set support
0
FLMLRC2 C, C++, and Resource file parser for workstation source
0
FLMLRC37 REXX C370 Parser
0
FLMLRDTL REXX DTL Parser
0
FLMLRIPF Script and OS/2 IPF Source Parser
0
FLMLSS General Purpose Parser
0
FLMLTWST Workstation Build translator
0
FLMTBMAP Build Map Print - Build translator
0
FLMTMJI Interface to JOVIAL Compiler
64
FLMTMMI Interface to DFSUNUB0 (phase 2 of MFSUTL and MFSTEST)
FLMTMSI Interface to SCRIPT/VS
24
FLMTPRE
0
FLMTPST
0
FLMTXFER Workstation Transfer - Build translator
0
SCLM parser restrictions
Non-explicit references
Separation of references
SCLM Variables and Metavariables
SCLM variable and metavariable descriptions
SCLM variable and metavariable tables
SCLM variable descriptions, variable names, and their SCLM functions
SCLM variables and their SCLM functions
SCLM metavariable descriptions, metavariable names, and their SCLM functions
SCLM metavariable contents
Description of group variables
Copyright IBM Corporation 1990, 2014