Deployment Operations LMi

Aldon Lifecycle Manager
(IBM i Edition)
Deployment Operations
Revised April 8, 2015

Agenda
Glossary
The deployment process
Success vs. failure
Error resolution tips
Glossary
Deployment
Process of placing objects into libraries not controlled by
Aldon LM(i)
Host
Development IBM i where Aldon LM(i) is installed
Remote
The receiving IBM i - local or IBM is in the network
Local
Target libraries residing on the host
Helpful hint
Deploy Promote
4 ways to initiate deployment
Automatically on promote
PDN, QUA or ITG
Deployment or install live
Set is defined by object even if promote is by task
From Work with Objects by Release

Deployment or install live (path 1, 47 or 48)
Select one or many objects
Use powerful sub setting for object selection
Ad hoc creation of a set (path 6, 1, F6)

Select objects or tasks
Profile can be deployment or install live but always acts like deployment
Copy an existing set definition (Path 6, 1, 3)

6 steps per deployment set
1. Define Build the deployment set

2. Extract Create save files from the definition
3. Send Transmit save files to selected location
4. Receive Create temporary libraries from the save files
5. Install Copy the objects from the temporary libraries to
the target libraries
6. Delete Remove the temporary libraries from the locations
1. 2. 3. 4. 5. 6.
Define Extract Send Receive Install Delete
Run on the host Run on the remote

Deployment menu
Follows structure of Aldon LM(i) main menu
Day to day activities on top half of the panel
The focus of this presentation but we use the setup items
Set up options on bottom half
CDSTMNU Deployment Menu
Type choice, press Enter.
1. Work with deployment sets

2. Work with targets
3. Display deployment log
11. Work with media definitions

12. Work with location definitions
13. Work with target definitions
14. Work with deployment profiles
Deployment steps
Ad hoc deployment set creation
1. 2. 3. 4. 5. 6.
Define the deployment set
Select a deployment profile to determine content,
targets/locations and rules
CADDDSTSET Add Deployment Set
Type choice.
Deployment profile . . PRDDPLYPRF + Name
Type options, press Enter. Press F21 to select all.

1=Select
Opt Deployment Set Definition Option

Specify definition
Select objects
Select targets
Enter a comment
Objects or tasks?
Prior to release 7.5 task must be closed before extract if doing ad
hoc deployment from PDN
Default targets or need to select?
CSPCSETDFN Specify Deployment Set Definition
Deployment set . . . . . : *NEW DPLY Status . . . . . . . . . . : NEW

Deployment profile . . . : PRDDPLYPRF Deploy from environment . : PDN
Release . . . . . . . . : PIL/INH/BASE
Type choices, press Enter. More: +

Comment . . . . . . . . Test Deployment Set
SNADS priority . . . . . 2 1=High, 2=Normal
Select objects . . . . . 2 1=By task, 2=Individually
Resident objects only. . N Y=Yes, N=No
Targets . . . . . . . . 2 1=All profile, 2=Select
Delete restore library 1 1=After last install, 2=No
Installation method default is 1

Leave method to 1 to run a pre- or post- installation exit
Page down to specify the exit details
Deployment set . . . . . . : *NEW DPLY Status . . . . . . . . . . : NEW

Deployment profile . . . . : PRDDPLYPRF Deploy from environment . : PDN
Release . . . . . . . . . : PIL/INH/BASE

Installation:
Method . . . . . . . . 1 1=Auto Install, 3=DB Job
If method 3 or 4: 4=Program, 9=None
DB file or program Name
Library . . . . . Name
Member (of DB file) Name, *FIRST
Option to specify a program or command that will be
executed before or after the installation of each target

Type choices, press Enter.

More: -
Installation (continued):
If method 1:
Function at begin 1 1=Command, 2=Program, 9=None
Command or program PREPGM Name
Library . . . . QGPL *RCVLIB, *LIBL, name
Parameters . . . .
Function at end . . 1 1=Command, 2=Program, 9=None

Command or program POSTCMD Name
Library . . . . QGPL *RCVLIB, *LIBL, name
Parameters . . . . PRINT(*YES)
12
Select objects
A list of tasks would be displayed instead if so selected on previous
screen
Use Position to and F17=Subset to locate and subset by date
CSELSETOBJ Select Objects for Deployment
Deployment profile . . : PRDDPLYPRF Deploy from environment: PDN

Release . . . . . . . : PIL/INH/BASE
Position to . . . . . . *TOP, *BOT, starting characters
Currently selected . . : 1
Type options, press Enter. Press Enter with no options to continue.

1=Select for set 4=Remove from set 8=Display attributes
Elig. -------- Deployment Copy --------

Opt Sel Object Type Attribute Known Env Release Date Version
> ACTGLP *FILE PF Yes PDN *SAME 03/08/04 00300006
1 DEMORPG2 *PGM RPG Yes PDN *SAME 01/25/04 00000000
NEWFILE *FILE PF Yes PDN *SAME 03/08/04 00100002
NEWOBJ *FILE PF Yes PDN *SAME 03/08/04 00100002
Select the targets applicable to this set if not using defaults
CSELSETTGT Select Deployment Set Targets
Deployment profile . : PRDDPLYPRF Deploy from environment . . . . : PDN

Release . . . . . . : PIL/INH/BASE
Subset . . . . . . . . 1 1=All, 2=Selected, 3=Non-selected
Position to . . . . . *TOP, *BOT, starting characters
Currently selected . : 1 of 2
Type options, press Enter.

1=Select for deployment 4=Remove from selection 8=Display attributes
---------- Target ----------- Install Install From

Opt Sel Name --- Location ---- Filter Map By Env
> PDNTGT ALDONCMS ALDONT01 None LIBGRP PDN
PDNTGT ALDONCMS ALDONT02 None LIBGRP PDN
Data conversion options specified on promote will carry forward
to the set when deploying on promote
CSPCDSTCNV Specify Data Conversion
Deployment profile . : PRDDPLYPRF Deploy from env. . . : PDN

Profile defaults:
CPYF FMTOPT . . . : *MAP *DROP Conversion program . : *NONE
Retain saved data : N Library . . . . . :
CPYF opt (1=*DFT, 2=*MAP/*DROP, 3=*MAP, 4=*DROP, 5=*NOCHK, 6=*NONE, 9=*NOCPY)

Conversion: Program (*DFT, *NONE, name) Library (*RCVLIB, *LIBL, name)
Retain (saved) data (Y=Yes, N=No, *=*DFT)
CPYF ---- Conversion ----- Retn

Object Type Opt Program Library Data
ACTGLP *FILE 1 *DFT *
Critical step can be scheduled

Set number assigned at this point
CATOSTRDST Auto-Start Deployment Set
Deployment set . . . . . : 0000814 DPLY Status now: NEW Request:

Last auto-start step . . 4 Step option number

Locations for send or
receive; or targets
for install . . . . 1 1=All eligible, 2=Select
Auto-Start Step ----- Schedule ---- Schedule date (*CURRENT,

0. None Date Time *MONTHSTR, *MONTHEND,
1. Start extract . . . . *CURRENT *NODELAY *MON, *TUE, *WED, *THU,
2. Start send . . . . . *CURRENT *NODELAY *FRI, *SAT, *SUN, date)
3. Start receive . . . . *CURRENT *NODELAY Schedule time (*CURRENT,
4. Start install . . . . *CURRENT *NODELAY *NODELAY, time)
Deployment set 0000814 added for release PIL/INH/BASE.

Deployment steps
Install live from Work with Objects by Release
1. 2. 3. 4. 5. 6.
Install live from Work with Objects
Now lets repeat the process using install live

CWRKOBJREL Work with Objects by Release
Position to . . . . . . . *TOP, *BOT, starting characters
Type options, press Enter. (*=Combined job)

25=Retire 27=Promote to Parent* 29=Move/define (library groups)*
35=Compare 37=Request promote to parent* 47=Install live* ...
More: - +
Opt Object Type Attribute D Release Envs Rl T Cnds E Chkout Dvp.
CLNADR2 *FILE PF INH/BAS P
CMSFLDREF *FILE PF INH/BAS P
COMMENTRY *PGM CBL INH/BAS P
COMMIO *SRCMBR CBL INH/BAS P
COMMPRT *PGM CBL INH/BAS P
47 CUSTCRTCL1 *PGM CLP INH/BAS I P +
DAILY *FILE PF K INH/BAS P
DAILY1 *FILE PF K INH/BAS P
Displays environments eligible for install live

Those which have a deployment profile
Not necessarily those with active objects
CSELILVENV Select Environments for Install Live
The following environments are eligible for install live.
Type default for the additional install live information.
Comment for log . . . .
Type options, press Enter

1=Select for install live
Opt Environment
ITG Integration
1 QUA Quality assurance
PDN Production
QUA profile selects PDN copy of object since there is no QUA
copy
CINSLIV Install Live
Environment . . . . . . : QUA
Type the additional install live information below, press Enter.
Comment for log . . . .

Do you wish to change:
Schedule . . . . . . . . . . . . . . N Y=Yes, N=No
Installation method . . . . . . . . N Y=Yes, N=No
Objects selected for install live:

Elig. Install Copy
Object Type Attribute Known Env Release
CUSTCRTCL1 *PGM CLP Yes PDN *SAME
1 objects selected for install live.

Its that easy! Behind the scenes we create a deployment set and
follow the same process as deployment
CSBMJOB Submit Job
Type choices, press Enter to submit job.

Press F12=Cancel to return without submitting a job.
Job Name . . . . . . . . ACMSINSLIV Name
Job description:
Name . . . . . . . . ACMSBATCH *USRPRF, name
Library . . . . . . ACMSCTL *LIBL, library
Job queue:
Name . . . . . . . . *JOBD *JOBD, queue
Library . . . . . . *LIBL *LIBL, library
Place job on hold . . . *JOBD *JOBD, *YES, *NO
Output queue:
Name . . . . . . . . . *USRPRF *JOBD, *USRPRF, queue
Deployment steps
Deployment from Work with Objects by
Release
1. 2. 3. 4. 5. 6.
Deployment from Work with Objects
Now lets repeat the process using deployment

CWRKOBJREL Work with Objects by Release

48=Deploy* 50=Merge into parent* 57=Request install live* ...
More: - +
Opt Object Type Attribute D Release Envs Rl T Cnds E Chkout Dvp.
CMSFLDREF *FILE PF INH/BAS P
COMMENTRY *PGM CBL INH/BAS P
COMMIO *SRCMBR CBL INH/BAS P
COMMPRT *PGM CBL INH/BAS P
48 CUSTCRTCL1 *PGM CLP INH/BAS I P +
DAILY *FILE PF K INH/BAS P
DAILY1 *FILE PF K INH/BAS P
Displays environments eligible for deployment

Those which have a deployment profile
Not necessarily those with active objects
CSELILVENV Select Environments for Deploy Objects
The following environments are eligible for deployment.
Type options, press Enter

1=Select for deploy objects
Opt Environment
ITG Integration
1 QUA Quality assurance
PDN Production
Select a deployment profile to determine content,
targets/locations and rules, as we did when creating an ad hoc
deployment set
CADDDSTSET Add Deployment Set
Deployment set . . . . . : *NEW DPLY

Deployment profile . . . : PRDDPLYPRF Deploy from environment . : QUA
Text . . . . . . . . . . :
Type options, press Enter. Press F21 to select all.

Press Enter with no options to continue.
1=Select
Opt Deployment Set Definition Option

Specify definition
Select objects
Select targets
Objects have already been selected and are not available
for change
Can still enter a comment for the log


Comment . . . . . . . . Test Deployment Set
SNADS priority . . . . . 2 1=High, 2=Normal
Select objects . . . . . 2 1=By task, 2=Individually
Resident objects only. . N Y=Yes, N=No
Targets . . . . . . . . 2 1=All profile, 2=Select
Delete restore library 1 1=After last install, 2=No
The objects have already been selected
CDSPSETOBJ Display Objects for Deployment

Currently selected . . . : 1
Type options, press Enter. Press Enter with no options to continue.

8=Display attributes
Elig. ------- Deployment Copy --------

Opt Sel Object Type Attribute Known Env Release Date Version
> CUSTCRTCL1 *PGM CLP Yes PDN *SAME 10/19/07 00000000
Auto-start options are the same as they were for defining

the ad hoc deployment set
CATOSTRDST Auto-Start Deployment Set
Deployment set . . . . . : 0000814 DPLY Status now: NEW Request:

Last auto-start step . . 4 Step option number

Locations for send or
receive; or targets
for install . . . . 1 1=All eligible, 2=Select
Auto-Start Step ----- Schedule ---- Schedule date (*CURRENT,

0. None Date Time *MONTHSTR, *MONTHEND,
1. Start extract . . . . *CURRENT *NODELAY *MON, *TUE, *WED, *THU,
2. Start send . . . . . *CURRENT *NODELAY *FRI, *SAT, *SUN, date)
3. Start receive . . . . *CURRENT *NODELAY Schedule time (*CURRENT,
4. Start install . . . . *CURRENT *NODELAY *NODELAY, time)
Deployment set 0000814 added for release PIL/INH/BASE.

Once again the deployment set has been created and will
be submitted for batch processing
CSBMJOB Submit Job
Type choices, press Enter to submit job.

Press F12=Cancel to return without submitting a job.
Job Name . . . . . . . . ACMSATOJOB Name
Job description:
Name . . . . . . . . ACMSBATCH *USRPRF, name
Library . . . . . . ACMSCTL *LIBL, library
Job queue:
Name . . . . . . . . *JOBD *JOBD, queue
Place job on hold . . . *JOBD *JOBD, *YES, *NO
Output queue:
Name . . . . . . . . . *USRPRF *JOBD, *USRPRF, queue
Deployment steps
1. 2. 3. 4. 5. 6.
Extract the deployment set
Aldon LM(i) host process

Creates save file ACMSCTL/SFOnnnnnnn
Where nnnnnn is the set number
Creates temporary library ACMS#Onnn

Duplicates the objects to the temporary library along
with any necessary source
Saves the temporary library to a save file
Saves the save file to ACMSCTL
For RSF, also creates a package (CRTRSFPKG)
Deployment steps
1. 2. 3. 4. 5. 6.
Send the deployment set
Aldon LM(i) host process

Sends the save file/package to the selected locations
via the method specified in the location profile
*TCP/IP executes send to the listener program on the
remote
RSF executes SNDRSFPKG
SNADS executes SNDNETF
At the end of the send step, the contents of the save
file exist on the remote machine
Deployment steps
1. 2. 3. 4. 5. 6.
Receive the deployment set
Aldon LM(i) remote process

Initiated from the host when a message is received
from the remote location saying the file/package has
arrived
Creates temporary library ACMS#Onnn on each
remote machine and restores the save file
TCP/IP listener program receives the save file
RSF executes RTVRSFPKG
SNADS executes RCVNETF
Uses job description ACMSRCTL/ARMTBCHJOB
At the end of the receive step, all required
source/objects are in the temporary library on the
remote
Deployment steps
1. 2. 3. 4. 5. 6.
Install the deployment set
Aldon LM(i) remote process

Moves the old objects to be replaced to a temporary $$ library
Removes file constraints, triggers and journals, if any

Copies the new objects into the target libraries
Creates logical files and SQL
Sets authorities
For physical files, copies data from the old if not promoted with
data or using CHGPF or ALTER TABLE
Reattaches file constraints, triggers and journals
At the end of the install step, everything is in the target library
Rebuilds the logical and SQL objects from source

source is sent but automatically deleted after install if
not deploying source
If archiving is active, saves the old objects from the
temporary $$ library to a SAVF (Annnnnnnnn) in
library ACMSRCTL new naming convention in 8.1B
Uses JOBD ACMSRCTL/ARMTBCHJOB
ACMSINSJOB data area in ACMSCTL library

controls ability to install multiple targets for the same
set on the same machine simultaneously
ACMSINSORD data area in ACMSCTL library
controls ability to use user defined dependencies to
order install of objects in a set extract is slower
Both data areas are set on the host machine
Deployment steps
1. 2. 3. 4. 5. 6.
Delete the temporary library
Deletes the temporary library from the location after

the last target has been installed successfully
Deployment steps
1. 2. 3. 4. 5. 6.
COMPLETE!
ALDONDMI Subsystem - Host
ALDONDMI subsystem on the host contains multiple

jobs for supporting deployment and web portal
ACMSNEPJOB monitors ALDONCMS message
queue for deployment job completion messages
ACMSCTL host listener job for TCP/IP
communications, receives messages from remote
machines
ACMSNEPSPL processes remote deployment
reports that are received by the host
ACMSWP manages sessions for Web Portal
ALDONDMI Subsystem - Remote
ALDONDMI subsystem on the remote contains one

job for the TCP/IP listener
ACMSRCTL remote listener job for TCP/IP
communications, receives job data and save files from
host machine
ACMSNEPJOB (Never Ending Program)
The NEP job that runs in batch is ACMSNEPJOB

Automates the deployment process by monitoring the
ALDONCMS message queue on the host, parsing the
messages, updating the status and submitting the next
step in the process
Ships as autostart job in the ALDONDMI subsystem
STRACMSNEP prior to release 7.5
STRLMINEP in later releases
The NEP (Never Ending Program)
Always in a MSGW status

Use ACMSPRTNEP to print log of messages
If someone is signed on as ALDONCMS, it may not

get a lock on the message queue
Never sign on as ALDONCMS unless instructed by technical
services!
SUCCESS OR FAILURE?
Determining success or failure
Start by monitoring set status on Work with Deployment sets

If Request field is blank then either there is some failure or not
started
CWRKDSTSET Work with Deployment Sets
Path 6, 1

2=Change 3=Copy 4=Delete 5=Display 10=Finish 11=Work with targets
12=Work with locations 13=Extract 14=Send 15=Receive 16=Install ...
Deployment Deployment -- Status --

Opt Set Release Profile Now Request Objs Date Time
0000541 DPLY INH/BAS PRDDPLYPRF NEW 1 04/10/03 10:32
0000664 DPLY INH/BAS PRDDPLYPRF EXR 1 06/13/03 16:03
0000681 DPLY INH/BAS PRDDPLYPRF EXT STR L 6 06/27/03 12:07
0000810 DPLY INH/BAS PRDDPLYPRF CML 3 08/17/03 14:11
0000814 DPLY INH/BAS PRDDPLYPRF STR STR LT 10 08/17/03 14:31
Subset: Sts:*ACT Rel:PIL/INH/BASE

Status codes
Whenever Now and Request are not equal:

L indicates send and/or receive has not yet started or has
ended with errors for a selected location
From Work with Deployment Sets, select option 12 to view location
status
T indicates install has not yet started or has ended with
errors for a selected target
From Work with Deployment Sets, select option 11 to view target
status
Monitor set status by location
Additional location information displayed
CWRKLOCSET Work with Locations of Deployment Set
Path 6, 1, 12
Deployment set . . . : 0000814 DPLY Status now: CMP Request:
Deployment profile . : PRDDPLYPRF Deploy from environment: . : PDN

2=Update status 5=Display 11=Work with targets 14=Send* 15=Receive*
16=Install* 17=Backout* 18=Delete restore library* 31=Display log
-- Status -- System System Deploy. Remote

Opt --- Location ---- Now Request Name Release Method Delay
ALDONCMS ALDONM01 CMP ALDONM01 V5R2M0 SNADS *NONE
ALDONCMS ALDONM02 RCR STR T ALDONM02 V5R1M0 TCP/IP *NONE
ALDONCMS ALDONM04 STR T ALDONM04 V5R1M0 SNADS *NONE
ALDONCMS ALDONT01 CML ALDONT01 V5R2M0 SNADS *NONE
ALDONCMS ALDONT02 CML RLD ALDONT02 V5R2M0 RSF *NONE
ALDONCMS ALDONT03 NEW STR T ALDONT03 V5R2M0 LOCAL *NONE
Command ===>
F3=Exit F4=Prompt F5=Refresh F11=View 2 F12=Cancel F13=Repeat
F16=Display profile F17=Subset F22=More functions F24=More Keys
Monitor set status by target
All target status and information displayed
CWRKTGTSET Work with Targets of Deployment Set
Path 6, 1, 11
Deployment set . . . : 0000814 DPLY Status now: CMP Request:
Deployemnt profile . : PRDDPLYPRF Deploy from environment .: PDN

2=Update status 5=Display 16=Install* 17=Backout* 31=Display log
---------- Target ---------- Status Loc Sts Deploy. Deploy. Install

Opt Name --- Location ---- Now Rqs Now Rqs Method Content Map By
PDNTGT ALDONCMS ALDONT01 INS CMP SNADS ALL LIBGRP
PDNTGT ALDONCMS ALDONT02 INF INS STR RSF ALL LIBGRP
PDNTGTA ALDONCMS ALDONM02 NEW INS NEW STR TCP/IP ALL LIBGRP
PDNTGTB ALDONCMS ALDONM02 BKO RLD TCP/IP ALL LIBGRP
PDNTGTC ALDONCMS ALDONM02 INR INS SNR STR TCP/IP ALL LIBGRP
PDNTGTA ALDONCMS ALDONT03 INE INS STR LOCAL ALL LIBGRP
Command ===>
F3=Exit F4=Prompt F5=Refresh F10=List by location F11=View 2
F13=Repeat F16=Display profile F17=Subset F24=More keys
Display the deployment log
Each step has an activity record in the log file ACMSCTL/DSTLOG
Use F11 to locate job information
CDSPDSTLOG Display Deployment Log

Path 6, 1, 31
Position to . . . . . . . *TOP, *BOT, date
Set --- Location ---- Target Release Date Time Activity

0000814 DPLY INH/BAS 08/17/03 14:11:46 CMP ADD
0000814 DPLY INH/BAS 08/17/03 14:24:19 RQS EXT
0000814 DPLY INH/BAS 08/17/03 14:25:00 CMP EXT
0000814 DPLY ALDONCMS ALDONT01 INH/BAS 08/17/03 14:25:11 RQS SND
0000814 DPLY ALDONCMS ALDONT01 INH/BAS 08/17/03 14:25:16 CMP SND
0000814 DPLY ALDONCMS ALDONT01 INH/BAS 08/17/03 14:25:19 RQS RCV
0000814 DPLY ALDONCMS ALDONT01 INH/BAS 08/17/03 14:25:28 CMP RCV
0000814 DPLY ALDONCMS ALDONT01 PDNTGT INH/BAS 08/17/03 14:25:28 RQS INS
0000814 DPLY ALDONCMS ALDONT01 PDNTGT INH/BAS 08/17/03 14:25:40 CMP INS
0000814 DPLY ALDONCMS ALDONT01 INH/BAS 08/17/03 14:25:42 RQS RLD
0000814 DPLY ALDONCMS ALDONT01 INH/BAS 08/17/03 14:25:45 CMP RLD
Display the development log
Activity records for extract and install are also written to

the development log (view 5)
CDSPDEVLOG Display Development Log
Position to . . . . . . . *TOP, *BOT, date

5=Display detail
Act Deployment Target

Opt Object Type Cde Set --- Location ---- Name
RCVENTRY *PGM PRM
RCVENTRY *PGM EXT 0000814 DPLY
RCVENTRY *PGM INS 0000814 DPLY ALDONCMS ALDONT01 PDNTGT
ERROR RESOLUTION
General error resolution tips
Start by reading the Aldon LM(i) reports, not the

joblog
All jobs (host and remote) run as ALDONCMS
WRKSPLF SELECT(ALDONCMS *ALL *ALL xxxxxxx*')
WRKUSRJOB ALDONCMS
The set number can be found in the user data of the

spool files
Work with All Spooled Files
1=Send 2=Change 3=Hold 4=Delete 5=Display 6=Release 7=Messages
8=Attributes 9=Work with printing status
Device or Total Cur
Opt File User Queue User Data Sts Pages Page Copy
PRTFINSDST ALDONCMS ALDONDMI 0007018 1 RDY 1 1
JOB042733 ALDONCMS ALDONDMI SQL RDY 3 1
JOB042735 ALDONCMS ALDONDMI SQL RDY 3 1
PRTFEXTSET ALDONCMS ALDONDMI 0007022 1 RDY 1 1
PRTFEXTSET ALDONCMS ALDONDMI 0007023 1 RDY 1 1
PRTFSNDRCV ALDONCMS ALDONDMI 0007022 RDY 1 1
PRTFRCVDST ALDONCMS ALDONDMI 0007022 1 RDY 1 1

Verify that user profile ALDONCMS has a minimum

of *USE authority to the commands:
CRTDUPOBJ, SAVLIB, SAVOBJ, RCVNETF, RSTLIB,
CRTLIB, DLTLIB, RNMOBJ, CRTSAVF, RCLRSC and
RSTOBJ
The NEP has to be up and running to make the

process automatic
Common errors on extract
Extract unable to create save file

Error Message: Runtime routine error OS does not match
the compiled object
Remote location is at a lower OS than the host
Change create commands to specify lower OS release
o Default TGTRLS for create commands option via Aldon LM(i) global options
o CHGCMDDFT for IBM i create commands
Must recompile the objects
Review report PRTFEXTSET on host machine
Common errors on send for TCP/IP
ALDONDMI subsystem may not be running on the

host and remote machines
TCP/IP listener job may not be running in
ALDONDMI subsystem on the host or remote
Port number on host location definition does not
match the port number in ACMSRCTL/ UTLPORTNO
on the remote
Host location definition does not match value in
ACMSRCTL/ARMTSYSNAM
Review report PRTSNDDST on host machine
Common errors on send for RSF
RSFSRV not up and running

Add to the system start-up program
RSF/STRRSFSRV SDLC(*NO) PPP(*NO) TCPIP(*YES)
RSF server directory entry not set up correctly

Each target location must have a server entry pointing to the
host machine

Common errors on send for SNADS
CPD8063 Deployment to User &1 &2 not done; user

ID is not valid
No directory entry on the host for ALDONCMS at the remote
location
CPF8068 Error detected while processing file to be
sent
Save file cannot be sent, probably because the remote
machines storage level is over the threshold
Common errors on receive
Set does not receive and the activity code is RQS

RCV (request receive)
Review report PRTSNDRCV on the host machine
and PRTRCVDST on the remote
Check setup for TCP/IP receive errors
ALDONDMI subsystem may not be up and running

on the remote system
Port number may not be correct in the UTLPORTNO
data area
Verify if the loopback test for TCP/IP communications
runs successfully
Accessed from Work with Location Definitions
Option 8=Run TCP loopback test
TCP/IP internal diagnostics
One report has information about both host and remote
systems
Aldon LM(i) version V083_07.4- (Beta version) Send "TCP Loop Back Test" Command
Printer file PRTFSNDTST Copyright (c) Aldon, Inc. 1989-2005
This System Name . . . . . . . . . . . . : Z731PRD_ALDONT01
This System Serial Number . . . . . . . : 10C153F
This System Port Number . . . . . . . . : 11472
Requesting User Id . . . . . . . . . . . : TONYS ALDONT01
Save file name . . . . . . . . . . . . . : ACMSTSTTCP
Send data base job file . . . . . . . . : ACMSRMTJOB
Remote job file library name . . . . . : Z731PRCTL
-- To Location - Remote System Name Location Description Remote URL or IP Address Remote Port#
TCPTEST ALDONX01 TCPTEST_ALDONX01 TCP/IP to ALDONX01 ALDONX01.HQ.ALDON.COM 11472
CMS2789 30 Save file record Send to remote system failed.
CMS9956 40 TCP deployment transmission failed. See previous diagnostic messages.
CMS9912 40 Program ACMSTCPTST completed with ERRORS.

64
The highest CMSnnnn message severity was 40.
Program ACMSTCPSND - Start execution: Mon Aug 15 17:40:49 2005
Debug switch = 1
action_request *SENDJOB
save_file_name ACMSTSTTCP
from_library_name QTEMP Then there is the debug report !
job_file_name ACMSRMTJOB
to_library_name
host_system_name
Z731PRCTL
Z731PRD_ALDONT01 All the action blow by blow
target_system_name TCPTEST_ALDONX01
to_user_id TCPTEST
to_net_addr ALDONX01 Switch 8 must be set on for
msg_user_id TONYS
msg_net_addr ALDONT01 listener job
install_live N
loop_back_test Y
Key length....: 16
Key values....: TCPTEST ALDONX01
URL test...length: 21 result: 0
URL content: ALDONX01.HQ.ALDON.COM
Translate URL into IP Address
Test host_ent for non-creation
Host address: -1407645435
Access host serial number
Host serial number is...: 10C153F
Host serial number length is...: 17
Encrypted serial no..: Ix1UmJttmJBdbKq=
Request block.: *SBMJOBF#01147#02Y#03Z731PRD_ALDONT01#04Ix1UmJttmJBdbKq=#05ACMSTSTTCP#06Q
Input file name...: QTEMP/ACMSTSTTCP
Socket established.
Socket address port...: 11472
Socket address I/P...: 2887321861
Request Block length..: 147

Including the failure!
Acknowledgement receive return code is: 0
Request Block acknowledgement received:
Data record sent...: *RCVRECD#01596#02Z731PRD_ALDONT01#03WBlbFoMMFog86pJ=#040000000001##
Record length sent...: 596
Waiting on receipt of ack. for data record.
Acknowledgement received for data record:
Data record sent...: *RCVRECD#01596#02Z731PRD_ALDONT01#03ThlYClJJCld53mG=#040000000009##
Record length sent...: 596
send() failed.
Bad News
No Acknowledgement
Check setup for RSF receive errors
Save file to receive data value not set to *PKG on

RSF requester directory entry
ALWRPC not set to *YES on RSF requester directory
entry
Verify whether RSF is working
SNDMSGRSF to user ALDONCMS to host from remote and
vice versa
End the NEP on host prior to sending message from remote to host
Remember to restart the NEP
Check setup for RSF receive errors
RSFSRV user profile must have special authorities

*SECADM, *ALLOBJ, *IOSYSCFG, *JOBCTL, *SAVSYS
and *SPLCTL
The ACMSRCTL/ARMTBCHJOB job description

must have RSF and RSFTOOLS in the library list
Any changes made to RSF setup require ending and
re-starting the RSF servers for the new changes to
take effect
Common errors on receive for RSF
Review reports PRTFSNDRCV on the host and PRTFRCVDST on

the remote
CMS2410 30 Message RSF4104 received attempting to execute the
following command. CPYFRSF ACTION(*SND)
FROMFILE($$LA4818/ACMSRMTJOB) SERVER(S101284M)
TOFILE(ACMSRCTL/RCV0002662) TGTRLS(V5R2M0). CPF2105 40
04/25/05 14:29:24 ACMSSNDRC2 Object ACMSRMTJOB in
$$LA4818 type *FILE not found. RSF4104 40 04/25/05 14:29:26
ACMSSNDRC2 Error copying file from/to remote system.
CHGCMDDFT CMD(CPYFRSF) NEWDFT('optimize(*SAVRST)') for RSF
version 7.2 or higher
RMT2706 Non recoverable error during receive
Check authority on RSTLIB command
Check the target release on the location profile
Check setup for SNADS receive errors
DSPNETA JOBACN field not *SEARCH

WRKNETJOBE (for ALDONCMS) action field not
*SUBMIT
JOBD ARMTBCHJOB missing from ACMSRCTL
Verify whether SNADS is working outside ALDON
LM(i)
SNDNETMSG to host from remote and vice versa
WRKDSTQ to ensure queue not held (on host) or not
RTY-FAIL
Common errors on install
Objects going to wrong libraries

Verify the installation mapping
Unable to get a lock on a file to be replaced

Requisite PF for deployed LF not in library list
Adjust target definition
Physical file has a logical defined over it that is not

registered to Aldon LM(i)
Aldon LM(i) has no way of knowing how to recreate it
Common errors on install
Review reports PRTFSNDINS on the host machine

and PRTFINSDST on the remote machine
If the install fails due to allocation problems, simply
take a 16 on the set again
No need to copy and start over!
So what have we learned?
Install live reduces keystrokes and decisions

And therefore errors
Four ways to initiate the deployment process

Six processing steps per set
Start by reading the reports when trouble shooting
Document/product compatibility
Updated as of:
Aldon LM(i) 8.1A
For more information
Telephone:
+1-781-577-4323 Direct
E-mail / Website:
support@rocketsoftware.com

Deployment Operations LMi

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Deployment Operations LMi

Uploaded by

Copyright:

Available Formats

Aldon Lifecycle Manager

Revised April 8, 2015

From Work with Objects by Release

Ad hoc creation of a set (path 6, 1, F6)

Copy an existing set definition (Path 6, 1, 3)

1. Define Build the deployment set

Run on the host Run on the remote

Type choice, press Enter.

1. Work with deployment sets

11. Work with media definitions

CADDDSTSET Add Deployment Set

Deployment profile . . PRDDPLYPRF + Name

Type options, press Enter. Press F21 to select all.

Opt Deployment Set Definition Option

Deployment set . . . . . : *NEW DPLY Status . . . . . . . . . . : NEW

Type choices, press Enter. More: +

Installation method default is 1

Deployment set . . . . . . : *NEW DPLY Status . . . . . . . . . . : NEW

Type choices, press Enter. More: +

Deployment set . . . . . : *NEW DPLY Status . . . . . . . . . . : NEW

Type choices, press Enter.

Function at end . . 1 1=Command, 2=Program, 9=None

Deployment profile . . : PRDDPLYPRF Deploy from environment: PDN

Type options, press Enter. Press Enter with no options to continue.

Elig. -------- Deployment Copy --------

CSELSETTGT Select Deployment Set Targets

Deployment profile . : PRDDPLYPRF Deploy from environment . . . . : PDN

Type options, press Enter.

---------- Target ----------- Install Install From

Deployment profile . : PRDDPLYPRF Deploy from env. . . : PDN

Type choices, press Enter.

CPYF opt (1=*DFT, 2=*MAP/*DROP, 3=*MAP, 4=*DROP, 5=*NOCHK, 6=*NONE, 9=*NOCPY)

CPYF ---- Conversion ----- Retn

Critical step can be scheduled

Deployment set . . . . . : 0000814 DPLY Status now: NEW Request:

Type choices, press Enter.

Last auto-start step . . 4 Step option number

Auto-Start Step ----- Schedule ---- Schedule date (*CURRENT,

Deployment set 0000814 added for release PIL/INH/BASE.

Now lets repeat the process using install live

Position to . . . . . . . *TOP, *BOT, starting characters

Type options, press Enter. (*=Combined job)

Displays environments eligible for install live

The following environments are eligible for install live.

Type default for the additional install live information.

Comment for log . . . .

Type options, press Enter

Type the additional install live information below, press Enter.

Comment for log . . . .

Objects selected for install live:

1 objects selected for install live.

Type choices, press Enter to submit job.

Job Name . . . . . . . . ACMSINSLIV Name

Now lets repeat the process using deployment

Position to . . . . . . . *TOP, *BOT, starting characters

Type options, press Enter. (*=Combined job)

Displays environments eligible for deployment

The following environments are eligible for deployment.

Type options, press Enter

CADDDSTSET Add Deployment Set

Deployment set . . . . . : *NEW DPLY

Type options, press Enter. Press F21 to select all.

Opt Deployment Set Definition Option

CSPCSETDFN Specify Deployment Set Definition

CPYF opt (1=DFT, 2=MAP/DROP, 3=MAP, 4=DROP, 5=NOCHK, 6=NONE, 9=NOCPY)

Position to . . . . . . . TOP, BOT, starting characters

Position to . . . . . . . TOP, BOT, starting characters

Position to . . . . . . . TOP, BOT, date