Extract Utility User's Guide - Supra - Cincom
Extract Utility User's Guide - Supra - Cincom Extract Utility User's Guide - Supra - Cincom
Setting the z/OS STACK parameterWhen you code the STACK parameter, you set aside an area of memory calledthe stack/heap for Extract to use. The stack/heap has two areas, theProcedure Call Stack and the Dynamic Memory Heap, as shown in the followingfigure:Stack0(Unused)Heapxxx KAs the figure shows, the stack starts at the beginning of the area. It storessome run-time information and all global variables. In addition, when eachprocedure starts, it allocates an area on the stack to store its local variables,and call and return information.As the procedure calls more nested procedures, the stack grows larger. As thenested procedures return, the stack grows smaller. Thus, the size of the stackdepends on the levels of nesting in the procedure calls, and the number andsize of the procedures' parameters and local variables. As the stack gets larger,it allocates space toward the heap area.The heap is the area that Extract dynamically allocates at run-time. Here,Extract stores internal context information, that is, variables that are notstored in the stack area. When Extract no longer needs the space, it is freed.As an area is freed, it can be reallocated. Thus, this area varies in size. When aprocedure allocates the first heap area, it starts at the end of the space. Whena procedure allocates a new area, it takes the new area from the space closerto the stack. As the following figure shows, when the stack and heap getlarger, the unused space between them gets smaller:Stack0(Unused)Heapxxx KExtract Utility User's Guide, P25-9513-03 26Chapter: 3. Executing the Extract utilitySection: Choosing run-time options in z/OS
Estimating the size of the stack/heapBecause the size of the stack/heap varies, it is difficult to provide reliableestimates or formulas to determine the size. It is best to use the STACK valueof at least 400K. If this number proves to be insufficient, increase it as neededuntil Extract runs successfully.You know when the size is too small because you receive an error message andan abend code at run-time. The message states that the stack and heap havecollided; that is, they are out of memory.To estimate how much larger to make the stack, consider the level ofcomplexity in the UCL program. Complex tasks require more space. Forexample, if the files from which you extract data have extraordinarily largelogical records, you may discover you need to increase the STACK value.Because the heap area is allocated dynamically, its size varies more than thestack and is harder to predict. The heap gets larger as the UCL gets morecomplex. The size of the heap depends on the number of control blocks Extractcreates for internal use.Extract Utility User's Guide, P25-9513-03 27Chapter: 3. Executing the Extract utilitySection: Choosing run-time options in z/OS
- Page 2 and 3: SQL Access for SUPRA Server PDM ®E
- Page 5 and 6: 5. Coding the Extract function ....
- Page 7 and 8: OpenVMS installation and tailoringD
- Page 9 and 10: The FUNCTION statement initiates th
- Page 11 and 12: Coding null argumentsDefault values
- Page 13 and 14: Validating programsThe program list
- Page 15 and 16: Running debug and trace for DBA uti
- Page 17 and 18: 3. Executing the Extract utilityOve
- Page 19 and 20: File definitions in z/OSThese files
- Page 21 and 22: File definitions in OpenVMSYou must
- Page 23 and 24: Choosing run-time options in z/OSZ/
- Page 25: Run-timeoptionsResults of different
- Page 29 and 30: Coding the UCL for the control sect
- Page 31 and 32: SCHEMA (schema-name)Description Req
- Page 33 and 34: Coding the UCL for the Extract func
- Page 35 and 36: ⎡DIRECT⎤⎢SERIAL⎥QUALIFIER (
- Page 37 and 38: ⎧D'dec-string'⎫⎪⎪KEY ( ⎨X
- Page 39 and 40: ⎡low-rrn⎤⎢⎥RRN - RANGE (⎢
- Page 41 and 42: SECONDARY-KEY(secondary-key)Restric
- Page 43 and 44: SELECT (f1element1[,f1element2,...,
- Page 45 and 46: ⎧RECORD ( ALL ⎫⎨⎬)⎩record
- Page 47 and 48: ♦Additional constraints apply in
- Page 49 and 50: This section explains the detailed
- Page 51 and 52: RestrictionsDescriptionFormatConsid
- Page 53 and 54: Format=”field-format-mask” Opti
- Page 55 and 56: Considerations♦♦♦♦♦Each X
- Page 57 and 58: Displacement=”subfield-displaceme
- Page 59 and 60: Extract examplesThe examples in thi
- Page 61 and 62: The output report listing is:---TTT
- Page 63 and 64: The output report listing is:1TIS/X
- Page 65 and 66: The first few records of the extrac
- Page 67 and 68: The output report listing is:---TTT
- Page 69 and 70: The first few records of the extrac
- Page 71 and 72: Extract Utility User's Guide, P25-9
- Page 73 and 74: 0 CSUL0307I : ALL CONTROL SECTIONS
- Page 75 and 76: IndexAaccess linkpathspecifying for
Setting the z/OS STACK parameterWhen you code the STACK parameter, you set aside an area of memory calledthe stack/heap for <strong>Extract</strong> to use. The stack/heap has two areas, theProcedure Call Stack and the Dynamic Memory Heap, as shown in the followingfigure:Stack0(Unused)Heapxxx KAs the figure shows, the stack starts at the beginning of the area. It storessome run-time information and all global variables. In addition, when eachprocedure starts, it allocates an area on the stack to store its local variables,and call and return information.As the procedure calls more nested procedures, the stack grows larger. As thenested procedures return, the stack grows smaller. Thus, the size of the stackdepends on the levels of nesting in the procedure calls, and the number andsize of the procedures' parameters and local variables. As the stack gets larger,it allocates space toward the heap area.The heap is the area that <strong>Extract</strong> dynamically allocates at run-time. Here,<strong>Extract</strong> stores internal context information, that is, variables that are notstored in the stack area. When <strong>Extract</strong> no longer needs the space, it is freed.As an area is freed, it can be reallocated. Thus, this area varies in size. When aprocedure allocates the first heap area, it starts at the end of the space. Whena procedure allocates a new area, it takes the new area from the space closerto the stack. As the following figure shows, when the stack and heap getlarger, the unused space between them gets smaller:Stack0(Unused)Heapxxx K<strong>Extract</strong> <strong>Utility</strong> <strong>User's</strong> <strong>Guide</strong>, P25-9513-03 26Chapter: 3. Executing the <strong>Extract</strong> utilitySection: Choosing run-time options in z/OS