0000555: Support of SMPE installation of FLAM

Notes
(0000611) Falk Reichbott (administrator) 2014-09-09 14:05	The SMPE package will be avaiable with version 5.0.32 of FLAM. The license packages for all customers can be created.

(0000612) Falk Reichbott (administrator) 2014-09-09 14:50	SMPE INSTALLATION OF FLAM ON z/OS --------------------------------- Installation tips and hints to install using SMP/E. Since z/OS hosts are usually not directly connected to the internet, there is a tarball available which can be downloaded and unwrapped on any PC or directly under USS. Inside the tarball you will find the FLAM V5 FOR Z/OS product FMID=FLAM5xx as a ++FUNCTION in RELFILE format. All files (including the XML files) must be transfered as binary, because these files are already EBCDIC-encoded. Additionally, there is a FLAM5xx.XMIT file which provides a couple of install job samples. The files are FLAM5xx.tar FLAM5xx.xmit In the download area, you can also find the FLAM5xx directory containing the extracted binary package with all the RELFILES for USS. After tar -xzf ./FLAM5xx.tar . there will be - FLAM5xx - an SMPNTS directory containing file GIMPAF.XML (binary) file GIMPAF.XSL (binary) dir SMPPTFIN (binary) dir SMPRELF (binray) Please upload the FLAM5xx directory in binary format somewhere into your z/OS USS file system, e.g. into /u/user/ or into /tmp, according to your conventions. It is important that you preserve the above SMPNTS directory structure. You should also upload FLAM5xx.xmit in binary to a data set, e.g. to userid.FLAM.SMPE.XMIT. After RECEIVE INDSN(FLAM.SMPE.XMIT) DSN('userid.FLAM.SMPE.CNTL') you will have seven jobs in userid.FLAM.SMPE.CNTL: - SMPGBL1 - A sample job which creates and initializes GLOBAL, TARGET (TGT1), and DLIB (DLB1) CSIs. There is no need for a specific FLAM GLOBAL. You can very well decide to share a common GLOBAL zone. Also, the zone names might be chosen to be more telling, e.g. FLAMT1 for TGT1 and FLAMD1 for DLB1. This job should finish with RC=00. - SMPZNE2 - A sample job which sets up SMP/E ZONEs, UTILITIES, OPTIONS and standard DDDEFs for GLOBAL, TGT1, and DLB1. This job should finish with RC=00. - SMPREC3 - This job does the RECEIVE FROMNTS from the SMPNTS directory designated above and basically should run as given. Of course, if zone and other names have been changed, please adjust. Due to the REJECT which is inserted to make the job repeatable, RC=12 might be seen. The RECEIVE command should end with RC=00. - SMPDDF4 - This job allocates TARGET and DLIB data sets for the FLAM V5 on z/OS. In addition, the according DDDEFs are defined to TARGET and DLIB. There are two small naming conventions imposed: TARGET data set names contain a "T1" qualifier. Similarly, DLIB data set names contain "D1". This is to support different TARGET and DLIB environments if you are running different versions of FLAM concurrently. And secondly, TARGET DSN low level qualifiers start with "F", DLIB DSN LLQs begin with "A". As usual in SMP/E, these must not be changed. If zone and other names have been changed, please adjust. RC=00 is expected from this job. - SMPAPL5 - The APPLY job basically should run unchanged. You might see RC=04 from this job due to message GIM44402W srcname WAS NOT ASSEMBLED . . . This is acceptable since we do not want SMP/E to initiate any assemblies outside the official development cycle. - SMPACP6 - The ACCEPT job which again should run basically unchanged. This job should finish with RC=00. - SMPALI7 - A sample job which defines data set aliases to the FLAM TARGET data sets. The alias names should be used in production job control. So, when you are migrating to a new version of FLAM, you just switch the aliases and the production job control remains unchanged. This job should finish with RC=00 at first time, if an alias already exist RC=08 is expected. For the demo package, the installation is now finished. You can test any conversion function using the program FLCL on files of up to 1MiB. The complete software package containing the demo license can be downloaded from the URLs below: German: http://www.flam.de/de/technology/download/software/ [^] English: http://www.flam.de/en/technology/download/software/ [^] Customers with a commercial license are provided with the following files (++PTF(FLICxx) for FMID(FLAM5xx): FLIC5xx.tar FLIC5xx.xmit In the customer specific download area (login required), you can also find the directory FLIC5xx containing the extracted package with all the RELFILES. FLIC5xx.tar contains the licensing ++PTF also in RELFILE format, and again, the .xmit file will provide install jobs. After tar -xzf ./FLIC5xx.tar . there will be - FLIC5xx - an SMPNTS directory containing file GIMPAF.XML (binary) file GIMPAF.XSL (binary) dir SMPPTFIN (binary) dir SMPRELF (binary) As before, please upload the FLIC5xx directory in binary format somewhere into your z/OS USS file system or extract the tarball on USS, e.g. into /u/user/ or into /tmp, according to your conventions. Again, it is important that you preserve the above SMPNTS directory structure. You should also upload FLIC5xx.xmit in binary to a data set, e.g. to userid.FLIC.SMPE.XMIT. After RECEIVE INDSN(FLIC.SMPE.XMIT) DSN('userid.FLIC.SMPE.CNTL') you will have three jobs in userid.FLIC.SMPE.CNTL: - SMPREC1 - This job does the RECEIVE FROMNTS from the SMPNTS directory designated above and basically should run as given. The RECEIVE command should end with RC=00. - SMPAPL2 - The APPLY job which basically should run unchanged. This job should finish with RC=00. - SMPACP3 - The ACCEPT job which again should run basically unchanged. This job should finish with RC=00. This license module is required to use the old FLAM4 components (utility, subprogram, record interface, subsystem, FKME). The new FLAM5 components (FLCL utility, FLUC byte and record interface, FLUC subprogram, ...) on files greater than 1 MiB and for productive purposes. To download the commercial license module, login on the page below with the account information that is provided to you by email: German: http://www.flam.de/de/license [^] English: http://www.flam.de/en/license [^] After installation, you should see at minimum the data sets below: SMPE.FLAM.[D1/T1.][A/F]CLIST CLIST Procedures SMPE.FLAM.[D1/T1.][A/F]DOCHTM Documents as HTML-files (binary) SMPE.FLAM.[D1/T1.][A/F]DOCZIP Documents as ZIP-files (binary) SMPE.FLAM.[D1/T1.][A/F]DOCPDF Documents as PDF-files (binary) SMPE.FLAM.[D1/T1.][A/F]DOCTXT Documents as text-files (EBCDIC) SMPE.FLAM.[D1/T1.][A/F]IMPORT Import file for linking with DLLs SMPE.FLAM.[D1/T1.][A/F]INCLUDE Include file for C-compiling SMPE.FLAM.[D1/T1.][A/F]JOBLIB Sample Batch-Jobs SMPE.FLAM.[D1/T1.][A/F]LOAD Programs, load modules and DLLs SMPE.FLAM.[D1/T1.][A/F]MSGS Messages for FLAM panels SMPE.FLAM.[D1/T1.][A/F]OBJ Object modules (for linking) SMPE.FLAM.[D1/T1.][A/F]PANELS ISPF Panels SMPE.FLAM.[D1/T1.][A/F]SKELS Skeletons for FLAM panels SMPE.FLAM.[D1/T1.][A/F]SRCLIB Examples as source (ASM, PLI, COBOL) SMPE.FLAM.[D1/T1.][A/F]SRCLIBC Examples as source (C, C++, JAVA) SMPE.FLAM.[D1/T1.][A/F]SAMPLE Several resources useful with FLAM

Issue History
Date Modified	Username	Field	Change
2014-09-09 14:04	Falk Reichbott	New Issue
2014-09-09 14:04	Falk Reichbott	Status	new => assigned
2014-09-09 14:04	Falk Reichbott	Assigned To	=> Falk Reichbott
2014-09-09 14:05	Falk Reichbott	Note Added: 0000611
2014-09-09 14:05	Falk Reichbott	Status	assigned => resolved
2014-09-09 14:05	Falk Reichbott	Fixed in Version	=> 5.1
2014-09-09 14:05	Falk Reichbott	Resolution	open => fixed
2014-09-09 14:50	Falk Reichbott	Note Added: 0000612

Relationships