SMP/E指南阅读日志zz

SMP/E是z/OS中用来安装、更新软件产品或产品模块，apply PTFs,APARs到系统中的工具。此外SMP/E能够跟踪、管理相关产品，模块之间的依赖关系。
概念：
1. elememts：在SMP/E中指需要安装、更新的load modules,marco,panel,dialog,source code等。
2. SYSMOD(system modification): 包括4种类型，function SYSMOD,PTF SYSMOD,APAR SYSMOD,user modification SYSMOD
3. SYSMOD identifier : SMP/E通过sysmod identifier来标示、跟踪需要安装、更新的SYSMOD。
3. distribution library : 包含SMP/E使用的所有elements,用来作为SMP/E的输入库，另一个作用是作为backup库，当生产系统出现问题是，可以从distribution library中回复稳定的版本。
4. target library : 包含runtime可执行的modules。
5. CSI(Consolidated Software Inventory): CSI是一个VSAM数据集，SMP/E使用CSI中记录的信息来跟踪distribution library和target library。就像图书馆的图书信息卡片一样，也可以理解为目录或清单。
每一个element在CSI中都有一个对应的entry。每一个entry包含element name,type,history,how the element was introduced into the system以及指向element所在的distribution library或target library的指针。
6. SMP/E zones : CSI中，entry是按DLIB或TLIB中element的installation status分组的。即，用来记录

DLIB中element的entry放在distribution zone,TLIB中element的entry放在target zone。就像图书馆存放书籍信息卡片的抽屉一样。除了distribution zone和target zone,CSI中还有global zone,它包含标示和描述每一个distribution zone和target zone的entry,SMP/E处理过程中用到的一些options信息，所有SMP/E开始处理的SYSMODs的状态信息，SYSMODs的exception data或error。

7. exception data ：在SMP/E中，exception data通常指HOLDDATA。

8. HOLDDATA : HOLDDATA记录了该SYSMOD应当被hold住。

1）ERROR HOLD : PTF 出错。

2）SYSTEM HOLD: 在安装SYSMOD之前需要进行某些system actions。

3）USER HOLD :在安装SYSMOD之前需要user perform某些actions。

SMP/E正是使用CSI中的global zone结合DLIB及TLIB中的信息进行安装和跟踪z/OS软件的。

如何使用SMP/E安装，更新软件产品
1. SET zone(global,target,distribution)。
2. RECEIVE SYSMOD into related datasets, RECEIVE命令将SYSMODcopy到SMP/E使用的dataset里面。
   datasets : SMPPTS,SMPTLIB
   在RECEIVE过程中，SYSMOD的MCS信息被copy到临时数据集SMPPTS，Relative file则被copy到SMPTLIB
   中。

   SYSMOD 包含SMP/E安装所需要的二类信息：
   1）告诉SMP/E所需安装的element和如何安装 （MCS ,modification control statements)
   2）所需安装的element本身
      可以通过不同的方式package到SYSMOD中：
      a) RELFILE format : 使用与MCS分开的relative files存放element本身,通常用于function
         SYSMOD。
      b) inline  format : 将MCS和element本身打包到一起。
      c) indirect library : 将element打包到DASD dataset中，与MCS分开（与RELFILE的区别？）。
 
   RECEIVE以后，SMP/E将SYSMOD和HOLDDATA相关的信息记录在golbal zone中，HOLDDATA是以++HOLD
   statement表明的，安装前需要特别处理或有错误的SYSMOD。

  
3. APPLY SYSMOD to the appropriate target libraries。APPLY会调用系统utilities将SYSMOD安装到
   target library中。
   APPLY是可以指定一个参数，只有在所有前提条件检查满足之后，才真正进行APPLY安装更新target
   library。APPLY调用相关的系统utilities将elements（来自SMPTLIB,SMPPTS,indirect library）
   update到target library。
   APPLY 完成后，相关elements被update到target library，SMP/E同时会更新target zone，用以记录
   更新target library完成状态。即每一个SYSMOD，每一个element(比如MOD,LMOD)都会在target zone中
   有一个entry。
   APPLY完成后，SMP/E会在global zone为每一个SYSMOD加一条entry,用以反映SYSMODE已经被APPLY到
   target zone。
  
如果发现安装有问题或者不稳定，需要恢复到原来的版本
4. RESTORE 将有问题的版本用distribution library中的element替换掉。
  
5. ACCEPT 在RECEIVE,APPLY完成后，我们可以通过ACCEPT把所需element备份到distribution library中。
   需要注意的是在ACCEPT之前，最好对已经安装/更新的element进行一段时间performance和stability的
   测试，因为一旦ACCEPT,之前的版本将不能再被恢复。ACCEPT后的版本是以后用来恢复的最updated的版
   本。
  
6. 如何查询SMP/E相关的信息
   1）TSO中用SMP/E panel进行交互查询
   2）LIST 命令
   3）REPORT　命令
　 4) 写程序调用CSI API查询

   SMP/E processing flow


7. SMP/E用到的datasets:
   SMPCSI : 是一个VSAM文件，SMP/E用来记录安装状态及target lib和distribution lib的相关信息。
   SMPPTFIN:指向MCS配置文件。
   SMPPTS  :相当于SYSMODs的仓库，由receive命令将SYSMOD member放到PTS里。每一个member对应MCS里
            的一个entry,MCS包含在SMPPTFIN指向的文件中。
   SMPPTSnn:当SMPPTS满了的时候，可以指定SMPPTS1,SMPPTS2...用于扩展。
   SMPMTS  :macros的target library ??
   SMPSTS  :source code的target library ??
   SMPLTS  :??
   SMPTLIB :用于存放receive命令从SMPPTFIN读取的relative files。会被REJECT,RESTORE或ACCEPT处理
            时删除。
   SMPCNTL :SMP/E COMMAND输入文件
   SMPHOLD :指向包含++HOLD和++RELEASE语句的文件。(SMP/E V3R1开始，这个文件需要放在unix 文件系
            统中)。
   SMPLOG/SMPLOGA
   SMPSCDS
  
   SMPRPT
   SMPOUT  :SMP/E的输出message,如果没有指定SMPLIST,SMPRPT，输出中还会有LIST output和report,
            V3R1开始，SMPOUT需要存放在unix 文件系统中。
   SMPSNAP :当SMP/E abend时，用来snap dump。
   SYSLIB  :当SMP/E调用汇编utility是用到的macro library。

 1) DEFINE CSI
//DEFZONES EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//GIMZPOOL DD DSN=SYS1.MACLIB(GIMZPOOL),DISP=SHR
//SYSIN    DD *
    DEFINE CLUSTER(  +
            NAME(SMPE.GLOBAL.CSI)  +
                VOLUMES(volid)  +
                CYLINDERS(100 10)  +
                FREESPACE(10 5)  +
                KEYS(24 0)  +
                RECORDSIZE(24 143)  +
                SHAREOPTIONS(2 3)  +
                    )  +
            DATA (  +
                NAME(SMPE.GLOBAL.CSI.DATA)  +
                CONTROLINTERVALSIZE(8192)  +
                )  +
            INDEX (NAME(SMPE.GLOBAL.CSI.INDEX)  +
                CONTROLINTERVALSIZE(4096)  +
                )
    REPRO INFILE(GIMZPOOL)  +
            OUTDATASET(SMPE.GLOBAL.CSI)
  /*

JCL example considerations
When coding the JCL, consider the following:
The high-level qualifier should not be SYS1 if the CSI data set is to be cataloged in a user
catalog. The low-level qualifier must be CSI.
The CSI is a key-VSAM (KSDS) data set.
SMP/E does not support cross-system sharing of the CSI; you cannot specify 4 as the
cross-system value for SHAREOPTIONS.

2) DEFINE ZONES
   GLOBALZONE
   TARGETZONE
   DLIBZONE
Note:
SMP/E provides a member in SYS1.SAMPLIB (GIMSAMPU) containing sample
UCLIN statements to define entries for a basic z/OS system. You can access this member
by use of standard system utilities. The sample definitions are syntactically correct and can
be used as the basis for your CSI entries. This sample is not complete for all systems, but
it is an example of the types of information various entries need. For examples of UCLIN to
define entries, see the UCLIN command in SMP/E Commands, SA22-7771, which shows
the UCLIN syntax for each entry type, and SMP/E Data Set Entries in SMP/E Reference,
which contains a description of the syntax plus examples and notes on its use.

8. SMP/E维护commands:
   RECEIVE
   REJECT
   APPLY
   ACCEPT

9.配置SMP/E使用环境
  i)设置SMP/E panel
    RDEFINE SYSUSER8 CL(TSOPROC)UACC(NONE)
    PE SYSUSER8 CL(TSOPROC) ID(USER) ACC(READ)
    SETR RACLIST(TSOPROC)REFRESH
  ii)DEFINE CSI
  ii)DEFINE SREL/OPTIONS/ZONE INDEX/DDDEF etc.
    使用SMP/E online dialog定义,snapshot如下：

查询结果：

 

以上是用panel定义GLOBAL ZONE的过程。
 
使用JOB定义TARGET ZONE和DLIB ZONE ： GIMSAMPU
JOB执行结果：
SMPLOG
SMPOUT
SMPRPT
查询：



发现用panel手工建立的GLOBAL ZONE和用JOB建立的TARGET ZONE,DLIB ZONE查询出来的结果不同，
TARGET ZONE和DLIB ZONE中多出了很多entry。

  10. SMP/E综合应用
   参考OMEGAMON的安装日志 OMEGAMON INSTALL 。