{"id":1362,"date":"2014-06-02T20:31:18","date_gmt":"2014-06-03T01:31:18","guid":{"rendered":"http:\/\/www.mantissa.com\/?page_id=1362"},"modified":"2014-06-02T20:34:40","modified_gmt":"2014-06-03T01:34:40","slug":"z86vm-profile-z86","status":"publish","type":"page","link":"https:\/\/www.mantissa.com\/dotcom2020\/z86vm-profile-z86\/","title":{"rendered":"z86VM PROFILE Z86"},"content":{"rendered":"

PROFILE Z86 is a z\/VM file that is used to define the components and users within a z86VM execution environment.<\/p>\n

The following diagrams are intended to provide a visual overview of the z86VM environment. In this example, we\u2019ll use the MGT server, the IO server and two z86 users. We\u2019ll also have two x86 defined disks to meet their combined storage needs.<\/p>\n

\"z86VM<\/a><\/p>\n

PROFILE Z86 A file<\/h1>\n

These components are defined within the PROFILE Z86 file.\u00a0 The PROFILE Z86 file is the main administrative initialization file for the z86VM environment. It is comparable to \/etc\/init, config.sys or SYS1.PARMLIB for UNIX\/LINUX, Windows and z\/OS operating systems respectively.<\/p>\n

There are a number of control points that must be pre-established for successful operation of z86VM. The parameters and their potential values follow. In particular, the zIO server and the two z86 users have their specific definitions within these profiles. You might consider that these definitions are really attempting to define the hardware associated with a virtual PC device.<\/p>\n

The note above saying that this might be replaced by IBM Wave is something that Mantissa and IBM are considering. Should the PROFILE Z86 become part of the official z86VM product at general availability, we expect an additional level of simplification to be undertaken in the profile definitions. For example, a generic profile could be created for an SME Server and another generic profile for DSL clients. Individual users could then associate themselves with the generic profile and list any exceptions (e.g. different memory or disk drive size).
\nProcessing rules associated with PROFILE Z86
\nFor processing purposes, all text may be in upper or lower case. However, when processed, it will be converted to upper case exclusively.<\/p>\n

Unless specified otherwise, only the last instance of a duplicate parameter will be recognized for processing.
\nBlank lines in the file are allowed and ignored.
\nComments are allowed across a single or multiple lines beginning with \/* and ending with *\/<\/p>\n

Comments on a line that includes a parameter must follow the parameter.\u00a0 For example,
\nz86id = z860001\u00a0\u00a0 \/* this is the first id\u00a0 *\/
\nis a valid line.
\nHowever,
\n\/* This is the first id\u00a0 *\/ z86id = z860001
\nis invalid and will result in the line being ignored.<\/p>\n

Required parameters are listed in bold.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

Parameter<\/b><\/span><\/p>\n<\/td>\n

\n

Function and values<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

Base z\/VM Set up<\/i><\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

tcpipname<\/i><\/span><\/p>\n<\/td>\n

\n

Name of the z\/VM TCP\/IP stack that is defined in the z\/VM setup.<\/span><\/p>\n

Default: <\/span>tcpipname = tcpip<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

link<\/i><\/span><\/p>\n<\/td>\n

\n

This is a z\/VM CP link command that can add multiple mini disks to the z86VM environment that may be necessary to host shared EXEC and MODULE files for users.\u00a0 <\/span>This command can be repeated in the profile.\u00a0<\/span><\/span><\/p>\n

Example:\u00a0 <\/span><\/span>Link userid 191 A91 rr<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

access<\/i><\/span><\/p>\n<\/td>\n

\n

This is a z\/VM CMS access command that associates a linked disk for the purpose of using it to find z\/VM related files that are shared across users. This command can be repeated in the profile.\u00a0<\/span><\/span><\/p>\n

Example: access A91 E<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

zIO server set up<\/i><\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

zio_start<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

name of the IO server \u00a0<\/span><\/span><\/p>\n

Example: <\/span>zio_start=z86io<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

vswitch<\/i><\/span><\/p>\n<\/td>\n

\n

This is the name of the virtual switch defined under z\/VM. Information about setting up the VSWITCH can be found in the <\/span>Appendix A<\/i><\/b><\/span>. Default: <\/span>vswitch = vsw86<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

vnicadr<\/i><\/span><\/p>\n<\/td>\n

\n

a device address number provided by the z\/VM admin that created the VSWITCH. Default: v<\/span>nicadr =\u00a0 <\/span>0100.<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

module<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

Name of the I\/O server program module that handles I\/O operations and is shipped by Mantissa. This is allowed to vary when a new release comes out.\u00a0<\/span><\/span><\/p>\n

Example: <\/span>module = zio5\u00a0 <\/span>module\u00a0 <\/span>a<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

x86hd<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

This can be multiple devices that make up the file system to be used by the IO server. These are logically concatenated together to act like a single storage area network.\u00a0<\/span><\/span><\/p>\n

Example: <\/span>x86hd = vadr startcyl #cyl volser<\/span><\/p>\n

x86hd = 0200 00001\u00a0 <\/span>10016 ZV0048<\/span><\/p>\n

x86hd = 0201 00001\u00a0 <\/span>10016 ZV0049<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

zio_end<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

signifies the end of the IO server profile \u00a0<\/span><\/span><\/p>\n

Example: <\/span>zio_end = Z86IO<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

z86 User Definition<\/i><\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

z86_start<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

Specify the userid to be defined. Marks the beginning of a z86 user profile\u00a0<\/span><\/span><\/p>\n

Example: <\/span>z86_start=DEMODSL<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

io_server<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

name of zIO server to link the z86 user\u00a0 <\/span><\/span>io_server = z86io<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

boot<\/i><\/span><\/p>\n<\/td>\n

\n

Specify the z\/VM mini disk to boot guests from. Default = 194\u00a0<\/span><\/span><\/p>\n

Device# startcyl #cyl volser<\/span><\/p>\n

e.g. <\/span>boot = 194 100 20 MANT01<\/b><\/span><\/p>\n

Default: boot = 194<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

module<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

Name of the z86VM program module that handles x86 operations and is shipped by Mantissa. This is allowed to vary when a new release comes out.\u00a0<\/span><\/span><\/p>\n

Example: <\/span>module = V0R1C3M MODULE A<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

vncport<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

The initial TCP\/IP port number to be used to connect z86VM users to an end user device via VNC service. Example: <\/span>vncport = 2000<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

vnicadr<\/i><\/span><\/p>\n<\/td>\n

\n

a device address number provided by the z\/VM admin that created the VSWITCH. Default: <\/span>vnicadr =\u00a0 <\/span>0100<\/b><\/span>.<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

pcimage<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

x86 image file name.<\/span><\/p>\n

Example: pcimage = smg.img<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

vmimage<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

z\/VM FileName FileType FileMode of image to be loaded to the I\/O Server as pcimage.<\/span><\/p>\n

Example: vmimage = sme8\u00a0 <\/span>img\u00a0 <\/span>a<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

memory<\/i><\/span><\/p>\n<\/td>\n

\n

The amount of memory to be associated with a guest virtual machine. A server may require more memory than a Desktop client.<\/span><\/p>\n

Default: <\/span>memory = 900m<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

hdmemory<\/i><\/span><\/p>\n<\/td>\n

\n

This signifies the amount of space within the IO file system to be reserved on behalf of this user. Default: <\/span>hdmemory = 6g<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

dbgmachine<\/i><\/span><\/p>\n<\/td>\n

\n

Name of a guest virtual machine that is used to debug the z86VM environment. This userid is set during creation of the boot parameters for a z86 user machine. \u00a0<\/span><\/span><\/p>\n

Default: <\/span>dbgmachine = null<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n

\n

getimage<\/i><\/span><\/p>\n<\/td>\n

\n

z\/VM file_name file_type file_mode for an image to be loaded from the I\/O Server.<\/span><\/p>\n

Example: <\/span>getimage = new img b<\/b><\/span><\/p>\n

(Must have enough free minidisk space available to load a compete image)<\/span><\/p>\n<\/td>\n<\/tr>\n

\n

z86_end<\/i><\/b><\/span><\/p>\n<\/td>\n

\n

This marks the end of this particular users profile\u00a0<\/span><\/span><\/p>\n

Example: <\/span>z86_end = DEMODSL<\/b><\/span><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Sample (minimum) PROFILE Z86 file<\/h1>\n
\/* *\/\r\n zio_start = Z86IO\r\n module = ZIO5 MODULE A\r\n x86hd = 0200\r\n zio_end = Z86IO<\/pre>\n
z86_start = DEMODSL\r\n io_server = Z86IO\r\n module = V0R3C3M MODULE A\r\n vncport = 8700\r\n pcimage = DSL.IMG\r\n vmimage = DSL2012\u00a0\u00a0 IMG\u00a0\u00a0\u00a0 A\r\n z86_end = DEMODSL<\/pre>\n
z86_start = SME8\r\n io_server= Z86IO\r\n module = V0R3C3M MODULE A\r\n vncport = 8701\r\n pcimage = SME.IMG\r\n vmimage = SME8 IMG\u00a0\u00a0 A\r\n z86_end = SME8<\/pre>\n","protected":false},"excerpt":{"rendered":"
PROFILE Z86 is a z\/VM file that is used to define the components and users within a z86VM execution environment. The following diagrams are intended to provide a visual overview of the z86VM environment. In this example, we\u2019ll use the MGT server, the IO server and two z86 users. We\u2019ll also have two x86 defined […]<\/p>\n","protected":false},"author":5,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-1362","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.mantissa.com\/dotcom2020\/wp-json\/wp\/v2\/pages\/1362","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mantissa.com\/dotcom2020\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.mantissa.com\/dotcom2020\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.mantissa.com\/dotcom2020\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mantissa.com\/dotcom2020\/wp-json\/wp\/v2\/comments?post=1362"}],"version-history":[{"count":4,"href":"https:\/\/www.mantissa.com\/dotcom2020\/wp-json\/wp\/v2\/pages\/1362\/revisions"}],"predecessor-version":[{"id":1368,"href":"https:\/\/www.mantissa.com\/dotcom2020\/wp-json\/wp\/v2\/pages\/1362\/revisions\/1368"}],"wp:attachment":[{"href":"https:\/\/www.mantissa.com\/dotcom2020\/wp-json\/wp\/v2\/media?parent=1362"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}